Mac上配置Java需先确认shell类型(zsh用~/.zshrc,bash用~/.bash_profile),再下载匹配架构的JDK至/Library/Java/JavaVirtualMachines/,用/usr/libexec/java_home -v 21动态设JAVA_HOME,并export PATH=$JAVA_HOME/bin:$PATH,最后source ~/.zshrc验证三命令版本一致。

在Mac上安装JDK并让JAVA_HOME精准指向你选定的版本,不是简单复制两行命令就能搞定的事——装错架构会报“Bad CPU type”,写死路径会导致升级后JAVA_HOME失效,改错shell配置文件则重启终端就回到解放前。
确认当前Shell类型并选对配置文件
打开终端,执行:
echo $SHELL
如果输出是/bin/zsh(Catalina及之后系统默认),后续所有环境变量必须写入~/.zshrc;若为/bin/bash,才用~/.bash_profile。别再照着老教程无脑改bash_profile,它在zsh下根本不会被加载。
这一步跳过会直接导致后续所有配置失效,且毫无报错提示。
下载并安装JDK到标准位置
方法一:官方.pkg安装包(推荐新手)
去Eclipse Temurin官网或Adoptium.net下载macOS版.dmg,注意核对芯片架构——Apple Silicon选aarch64,Intel选x64。双击dmg→运行pkg→一路继续。安装完成后JDK自动落进/Library/Java/JavaVirtualMachines/,例如temurin-21.jdk。
方法二:Homebrew一键安装(适合终端熟练者)
先确保已装Homebrew,然后执行:
brew install --cask temurin@21
该命令会自动完成下载、校验、安装、注册全流程,比手动pkg更易批量管理多版本。
【关键提醒】不要用brew install openjdk@21——它装在/opt/homebrew/opt/openjdk@21目录下,不被/usr/libexec/java_home识别,IDEA也无法自动发现。
查找目标JDK的真实Home路径
在终端中运行:
/usr/libexec/java_home -V
你会看到类似这样的输出:
17.0.1 (x86_64) "Eclipse Temurin" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
21.0.1 (aarch64) "Eclipse Temurin" /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
注意:每行末尾的路径才是真正的JDK根目录,必须包含/Contents/Home这一段。别把前面的.jdk目录当HOME,否则javac会找不到tools.jar。
配置JAVA_HOME并生效
第一步:编辑配置文件
执行:
code ~/.zshrc
(如果你用VS Code;若用nano则用nano ~/.zshrc)
第二步:添加两行配置(不可省略export)
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH
第三步:保存文件后立即生效
source ~/.zshrc
第四步:验证是否成功
echo $JAVA_HOME
java -version
javac -version
三者输出的版本号必须一致,且JAVA_HOME路径末尾必须是/Contents/Home。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











