macOS配置Java开发环境需安装JDK并设置JAVA_HOME和PATH:先用java -version确认版本,推荐Adoptium Temurin等JDK;通过/usr/libexec/java_home -V查路径,再在~/.zshrc中导出JAVA_HOME和更新PATH,最后source生效。

在 macOS 上配置 Java 开发环境,核心是正确安装 JDK 并设置好 JAVA_HOME 和 PATH 环境变量。系统自带的 Java(旧版)通常不支持现代开发,建议使用官方或主流开源 JDK(如 Oracle JDK、Adoptium Temurin、Azul Zulu 或 Amazon Corretto)。
确认已安装合适的 JDK
打开终端,运行:
java -version
如果提示“command not found”,说明未安装 JDK;如果版本过低(如 1.8 且你需要 Java 17+),需重新安装。推荐从以下任一渠道下载安装:
- Adoptium(Eclipse Temurin):https://adoptium.net/(免费、主流、更新及时)
- Zulu(Azul):https://www.azul.com/downloads/(含 LTS 和最新版)
- Oracle JDK:https://www.oracle.com/java/technologies/downloads/(需注册,个人免费)
安装 .dmg 后,JDK 默认路径为 /Library/Java/JavaVirtualMachines/。
立即学习“Java免费学习笔记(深入)”;
查找并验证 JAVA_HOME 路径
终端中执行以下命令,列出所有已安装 JDK:
/usr/libexec/java_home -V
输出类似:
17.0.1 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 17" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home 11.0.20 (x86_64) "Amazon.com Inc." - "Amazon Corretto 11" /Library/Java/JavaVirtualMachines/amazon-corretto-11.jdk/Contents/Home
复制你希望默认使用的 JDK 的完整路径(即 /Library/.../Home 那一行),这就是你要设的 JAVA_HOME 值。
设置 JAVA_HOME 和 PATH(针对 zsh)
macOS Catalina(10.15)及之后默认使用 zsh,配置文件是 ~/.zshrc。编辑它:
nano ~/.zshrc
在文件末尾添加(请将路径替换为你查到的实际路径):
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH
保存后退出(Ctrl+O → Enter → Ctrl+X),再执行:
source ~/.zshrc
验证是否生效:
echo $JAVA_HOME java -version
两个命令都应输出预期结果,无报错即成功。
IDE 和终端保持一致(可选但推荐)
某些 IDE(如 IntelliJ IDEA)可能不读取 shell 的 .zshrc,尤其是通过 Dock 或 Spotlight 启动时。解决方法:
- 在 IntelliJ 中:Preferences → Build, Execution, Deployment → Build Tools → Maven → Importing → JDK for importer → 选择对应 JDK
- 或统一用终端启动 IDE:
open -a "IntelliJ IDEA"(确保该终端已加载.zshrc) - VS Code 用户:确保在 VS Code 内置终端中执行
source ~/.zshrc,或在settings.json中设置"terminal.integrated.env.osx": { "JAVA_HOME": "/path/to/jdk" }
不复杂但容易忽略










