mac配置java、maven、gradle三步:装jdk(推荐sdkman!)、设java_home及path、验证命令;maven解压设maven_home和path;gradle推荐brew安装;ide需从终端启动以继承环境变量。
mac 上配好 java、maven 和 gradle,核心就三件事:装对 jdk、设好环境变量、验证能跑命令。别被一堆路径和 shell 文件吓住,其实逻辑很清晰。
确认并安装合适的 JDK
macOS 12 及以后版本不自带 JDK,只带个不能编译的 JRE。运行 java -version 和 javac -version 都得有输出才算真正装好。
- 推荐用 SDKMAN! 安装 OpenJDK(如 temurin-17.0.9+9),它会自动管理多个 JDK 版本,且路径规范
- 如果手动安装 Oracle 或 Temurin DMG 包,JDK 默认路径是
/Library/Java/JavaVirtualMachines/jdk-xx.jdk/Contents/Home - 务必在
~/.zshrc中设置JAVA_HOME,例如:export JAVA_HOME=$(/usr/libexec/java_home -v 17)(动态获取)或export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home(固定路径) - 然后把
$JAVA_HOME/bin加进PATH,否则javac就找不到
Maven:解压 + 设置 MAVEN_HOME + PATH
官网下载 apache-maven-X.X.X-bin.tar.gz 后,解压到用户目录下(比如 ~/develop/maven),避免权限问题。
- 编辑
~/.zshrc,添加两行:export MAVEN_HOME=~/develop/apache-maven-3.8.6export PATH=$MAVEN_HOME/bin:$PATH - 不要用
M2_HOME(旧写法),现代工具(包括 IntelliJ)更认MAVEN_HOME - 执行
source ~/.zshrc生效;首次运行可加执行权限:chmod +x $MAVEN_HOME/bin/mvn - 验证:
mvn -v应显示 Maven 版本、Maven home 路径、Java version —— 三者缺一不可
Gradle:二选一,推荐 brew 管理
Gradle 不像 Maven 必须手动解压,两种方式都可行,但维护成本不同:
-
方式一(推荐):用 Homebrew 安装
brew install gradle→ 自动配置好路径和版本切换,升级也方便 -
方式二:手动下载解压
下载gradle-X.X-bin.zip,解压到~/develop/gradle,再在~/.zshrc中添加:export GRADLE_HOME=~/develop/gradle-8.10export PATH=$GRADLE_HOME/bin:$PATH - 无论哪种,验证都用
gradle -v,重点看 Groovy、Ant、JVM 版本是否与你的 JDK 兼容(例如 Gradle 8.x 要求 JDK 17+)
终端与 IDE 的一致性要点
IntelliJ IDEA 或 VS Code 运行 Maven/Gradle 时,有时提示“command not found”,往往不是工具没装,而是 IDE 没读到你的 shell 配置。
- 确保 IDE 是从终端启动(例如在终端输入
open -a "IntelliJ IDEA"),这样它才能继承~/.zshrc中的环境变量 - 在 IntelliJ 中,进入 Settings → Build, Execution, Deployment → Build Tools → Maven,确认 “Maven home path” 指向你设的
$MAVEN_HOME,而非内置版本 - Gradle 同理,在对应设置里选 “Use Gradle from wrapper” 或指定
GRADLE_HOME路径 - 如果用 VS Code,装好 Java 扩展包后,项目根目录下有
pom.xml或build.gradle,插件会自动识别并启用构建支持
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











