Mac配置Java的zsh环境变量核心是三步：确认JDK已安装且版本匹配；用/usr/libexec/java_home -v X动态获取路径写入~/.zshrc，设JAVA_HOME并前置$JAVA_HOME/bin到PATH；执行source ~/.zshrc后验证echo $JAVA_HOME、java -version与javac -version三者一致。
Mac 上配置 Java 的 zsh 环境变量，核心就三件事：确认 JDK 已装对、把 JAVA_HOME 和 PATH 正确写进 ~/.zshrc、再让它生效。不是改错文件，就是路径写死或顺序不对——这两点占了 90% 的失败原因。
确认你用的是 zsh，并检查 JDK 是否已安装
打开终端，先执行：
-
echo $SHELL—— 输出/bin/zsh才说明你在用 zsh（macOS Catalina 及之后默认如此） -
java -version和javac -version—— 如果报command not found，说明 JDK 没装；如果版本号不一致，说明只装了 JRE -
/usr/libexec/java_home -V—— 列出所有已安装的 JDK，确认你要用的版本（如17.0.1或21）存在
在 ~/.zshrc 中正确设置 JAVA_HOME 和 PATH
别手敲 JDK 路径，用系统命令动态获取，避免升级后失效：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 运行：
nano ~/.zshrc - 在文件末尾添加两行（以 JDK 17 为例）：
export JAVA_HOME=$(/usr/libexec/java_home -v 17)export PATH=$JAVA_HOME/bin:$PATH -
注意顺序：把
$JAVA_HOME/bin放$PATH前面，否则系统可能优先调用/usr/bin/java（旧版或占位符） - 保存：按
Ctrl+O→ 回车 →Ctrl+X退出
让配置立即生效并验证是否成功
改完不 source 就等于没改：
立即学习“Java免费学习笔记（深入）”；
- 运行：
source ~/.zshrc - 验证三者必须一致：
echo $JAVA_HOME→ 应显示类似/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Homewhich java→ 应返回/Users/xxx/.sdkman/candidates/java/current/bin/java或$JAVA_HOME/bin/java（不是/usr/bin/java）java -version与javac -version→ 主版本号和厂商信息需完全相同
常见问题快速排查
如果验证失败，优先看这几处：
- 终端新开窗口后仍无效？检查 VS Code 或 iTerm2 是否启用了「Login shell」（非登录模式不自动读
.zshrc） -
which java还是/usr/bin/java？说明PATH顺序错了，或者有其他配置（如.zprofile、.bash_profile）覆盖了你的设置 - IDE（如 IntelliJ）里 Java 版本不对？IDE 启动时可能没继承终端环境，需在 IDE 设置中手动指定 JDK 路径，不要依赖环境变量
- Homebrew 安装的 OpenJDK？路径通常是
/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，同样用/usr/libexec/java_home -v 17能正确识别
