Mac上Java环境配置失败主因是shell配置文件选错、JAVA_HOME未用/usr/libexec/java_home动态获取、PATH未将$JAVA_HOME/bin置顶，须编辑~/.zshrc并source生效，再通过java -version、javac -version和echo $JAVA_HOME三者一致验证。
直接结论：用 /usr/libexec/java_home -v 17 动态获取路径，写进 ~/.zshrc，再 source ~/.zshrc —— 硬编码路径、用 .bash_profile、漏掉 $JAVA_HOME/bin 置顶，这三处最容易出问题。
为什么不能硬写 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
Mac M3 芯片安装 JDK 17 后，路径看似固定，但实际可能因版本号小数点后数字（如 jdk-17.0.8.jdk）、厂商（Oracle/Temurin/Zulu）或更新方式不同而变化。硬编码会导致：
-
java -version正常，但javac找不到 —— 因为PATH没指向正确的bin目录 - 升级 JDK 后环境变量立即失效，必须手动改路径
- 如果同时装了多个 JDK，
/usr/libexec/java_home -V显示的路径和你写的不一致，JAVA_HOME就指向了空壳目录
该往哪个文件里写配置：一定是 ~/.zshrc
macOS Catalina（10.15）起默认 shell 是 zsh，不是 bash。M3 芯片的 macOS Sonoma/Ventura/VisionOS 全部沿用此设定。写错文件等于白配：
- 写在
.bash_profile或.profile：终端新开一个窗口后$JAVA_HOME为空，java命令仍不可用 - 写在
/etc/zshrc或/etc/profile：影响所有用户，且权限不足时会报Permission denied - 正确做法：用
echo $SHELL确认是/bin/zsh后，只编辑~/.zshrc
配置内容必须包含这两行，顺序不能反
环境变量生效依赖加载顺序。$JAVA_HOME/bin 必须放在 PATH 最前面，否则系统可能优先找到系统自带的旧版 java（比如 macOS 自带的 JRE）：
export JAVA_HOME=$(/usr/libexec/java_home -v 17) export PATH=$JAVA_HOME/bin:$PATH
-
/usr/libexec/java_home -v 17会自动匹配已安装的 JDK 17（支持 Oracle/Temurin/Zulu），返回真实路径，比手动 ls 更可靠 - 不要加
CLASSPATH：现代构建工具（Maven/Gradle）和 IDE 自己管理类路径，硬设反而干扰编译 - 别漏掉
export：没 export 的变量只在当前 shell 进程有效，子进程（如 IDE 启动的终端）看不到
验证是否真的生效，三个命令缺一不可
只跑 java -version 不够，它可能来自系统缓存或 alias。真正要确认的是三者一致：
-
java -version→ 输出含17.的版本号 -
javac -version→ 输出同样版本号（证明bin目录被正确加入PATH） -
echo $JAVA_HOME→ 输出路径必须和/usr/libexec/java_home -v 17完全一致
如果三者不统一，大概率是 PATH 里有其他 JDK 的 bin 目录排在前面，或者 source 没执行成功。
