Mac Java环境配置失败主因是shell配置错误：需确认用zsh（Catalina起默认），改~/.zshrc而非~/.bash_profile；JAVA_HOME须用/usr/libexec/java_home动态获取；PATH要写成export PATH=$JAVA_HOME/bin:$PATH；最后source ~/.zshrc并新开终端验证三命令版本一致。
Mac 上 Java 环境配不起来，问题通常不出在 JDK 是否装好，而在于 shell 配置是否对路——文件选错、路径写死、PATH 顺序不对、没生效，这四点占了九成失败原因。
确认当前 shell 类型
macOS Catalina（10.15）起默认使用 zsh，不是 bash。很多教程还在教改 ~/.bash_profile，但系统根本不会读它。
- 执行
echo $SHELL，输出/bin/zsh就说明你在用 zsh - zsh 默认加载的是
~/.zshrc，不是~/.bash_profile或~/.profile - 如果非要用旧配置，可在
~/.zshrc最后加一行：source ~/.bash_profile，但推荐统一挪到~/.zshrc
正确设置 JAVA_HOME
JAVA_HOME 不能手写路径，比如 /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home —— 这样写看似能用，但换版本或重装就立刻失效。
- 用 macOS 自带命令动态获取：
/usr/libexec/java_home -v 21（查 JDK 21）或/usr/libexec/java_home -v 17（查 JDK 17） - 在
~/.zshrc中写成：export JAVA_HOME=$(/usr/libexec/java_home -v 17) - 这样无论你装几个 JDK，只要版本号不变，路径就自动适配
安全添加 PATH 并验证顺序
PATH 写错会直接让 ls、cd 等基础命令失效，或者调用错版本的 java。
立即学习“Java免费学习笔记（深入）”；
- 必须写成：
export PATH=$JAVA_HOME/bin:$PATH（注意$JAVA_HOME/bin在前） - 千万别写成
export PATH="/some/path"——这会覆盖整个 PATH - 也别漏掉
export，否则变量只在当前行生效
让配置生效并完整验证
改完文件不等于环境就更新了，必须显式加载，且要在新终端里测才真实反映 IDE 或脚本的行为。
- 执行
source ~/.zshrc使当前终端立即生效 - 新开一个终端窗口，运行三句命令检查是否一致：
java -versionjavac -versionecho $JAVA_HOME- 三者显示的 JDK 版本和路径必须完全匹配才算成功
