Mac上Java环境变量配不成功，八成是因为改错了配置文件——Catalina（10.15）起默认用zsh，应改~/.zshrc而非~/.bash_profile；JAVA_HOME须用/usr/libexec/java_home动态获取；PATH必须写成export PATH=$JAVA_HOME/bin:$PATH；最后source ~/.zshrc并验证java -version、echo $JAVA_HOME、which java三者一致。
Mac上Java环境变量配不成功，八成是因为改错了配置文件——Catalina（10.15）及之后系统默认用 zsh，.bash_profile 不会自动加载，直接改它等于白忙。
怎么确认该改 .zshrc 还是 .bash_profile
别猜，终端里执行：echo $SHELL。输出是 /bin/zsh → 必须改 ~/.zshrc；输出是 /bin/bash → 才考虑 ~/.bash_profile（但新装系统几乎不会出现）。
注意：哪怕你以前配过 .bash_profile，只要没手动执行 chsh -s /bin/bash 切回 bash，它就只是个闲置文件。
JAVA_HOME 不能硬编码路径，必须用 /usr/libexec/java_home
macOS 的 JDK 安装路径随版本、厂商（Oracle/Adoptium/Zulu）、架构（Intel/M1/M2/M3）变化极大，比如：/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home 下次升级或换 JDK 就失效。
正确做法是动态获取：
- 查所有已装 JDK：
/usr/libexec/java_home -V - 指定版本（推荐，避免多版本冲突）：
export JAVA_HOME=$(/usr/libexec/java_home -v 17) - 只装一个 JDK 可省略
-v，但建议留着——防止后续装了多个后java -version和$JAVA_HOME对不上
PATH 添加顺序错，java 命令就永远调不到你配的 JDK
常见错误写法：export PATH=$PATH:$JAVA_HOME/bin —— 这会让系统自带的 /usr/bin/java（通常是过时的旧版）永远优先。
必须把你的 JDK bin 放最前面：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
- 正确写法：
export PATH=$JAVA_HOME/bin:$PATH - 别漏
export，否则变量只在当前行生效 - 别覆盖整个
PATH（如export PATH="/path/to/java/bin"），否则ls、cd都会失效
改完不 source，等于没改；验证只看 java -version 是最大误区
执行 source ~/.zshrc（不是 source ~/.bash_profile）让配置立即生效，别关终端重开——容易漏掉未生效的验证步骤。
验证必须三者一起看：
-
java -version→ 实际执行的 JDK 版本 -
echo $JAVA_HOME→ 是否和上面一致 -
which java→ 路径是否为$JAVA_HOME/bin/java，不是/usr/bin/java
三者不一致，说明 PATH 或 JAVA_HOME 设置有冲突，常见于重复 source、多行 export、或 IDE 自身设置了 JDK 路径覆盖了环境变量。VS Code 内置终端、iTerm2 非登录模式等场景下，.zshrc 默认不加载，这不是配置错，而是 shell 启动模式问题——这点最容易被忽略。
