homebrew是mac安装maven和gradle最省心的方式：先执行命令安装homebrew，再用brew install maven或gradle一键完成安装与环境变量配置，无需手动编辑path或配置文件，安装后分别运行mvn -v或gradle -v验证即可。

直接用 homebrew 安装 maven 或 gradle 是 macos 上最省心、最可靠的方式——它自动处理路径、依赖和环境变量，不用手动改配置文件，也不用担心 path 写错。

安装前先装好 Homebrew

如果还没装 Homebrew，打开终端粘贴执行：

• /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 安装完成后运行 brew --version 确认可用
• 再执行 brew update 同步最新软件源

用 brew 一步装好 Maven

Maven 安装后即可全局使用 mvn 命令，无需额外配置：

macOS Local Voice

利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。

下载

• 终端输入：brew install maven
• 等安装完成，运行 mvn -v
• 看到 Maven 版本、Java 版本和 M2_HOME 路径，就说明成功了

用 brew 一步装好 Gradle

Gradle 同样开箱即用，但需确保 Java 环境就绪：

• 先确认 JDK 已安装且版本 ≥11（推荐 brew install openjdk@17）
• 运行 brew install gradle
• 执行 gradle -v 查看输出：含 Gradle 版本、JVM 版本及 Groovy/Kotlin 版本即为正常
• 如提示 “Unsupported Java version”，说明 JAVA_HOME 没指向正确 JDK，可用 export JAVA_HOME=$(/usr/libexec/java_home -v 17) 临时设置，或写入 ~/.zshrc

后续建议：配好 settings.xml（Maven）或 init 脚本（Gradle）

装完只是起点，真正提升构建效率要靠定制化配置：

• Maven 可修改 ~/.m2/settings.xml：添加阿里云镜像源、指定本地仓库路径
• Gradle 推荐用 gradle init 创建新项目，生成标准结构；也可在 ~/.gradle/init.gradle 中统一配置仓库地址
• 在 IntelliJ IDEA 中，进入 Preferences → Build, Execution, Deployment → Build Tools，分别指定 Maven 或 Gradle 的路径、settings.xml 和本地仓库，避免 IDE 和命令行行为不一致