在macOS上如何配置Java开发环境_Java环境变量设置说明

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_HOMEPATH 环境变量。系统自带的 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/.jdk/Contents/Home

查找并验证 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" }

不复杂但容易忽略