/usr/libexec/java_home -V 显示的是JDK安装根目录（如/Library/Java/JavaVirtualMachines/jdk-21.jdk），而JAVA_HOME必须精确指向其Contents/Home子目录，因JDK工具链（如javac、tools.jar）均位于该路径下；直接使用-V输出会导致工具不可用，正确做法是手动补全/Contents/Home或用/usr/libexec/java_home -v 21直接获取完整路径。
为什么 /usr/libexec/java_home -V 显示的路径不能直接当 JAVA_HOME 用
因为 /usr/libexec/java_home -V 输出的是 JDK 安装目录（如 /Library/Java/JavaVirtualMachines/jdk-21.jdk），而 JAVA_HOME 必须指向其内部的 Contents/Home 子目录。直接复制第一行路径设为 JAVA_HOME 会导致 javac 找不到工具、Maven 报 tools.jar 缺失等错误。
正确做法是：从命令输出中取完整路径，手动补上 /Contents/Home。例如：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
- Mac 上所有通过 .dmg 安装的 JDK 都遵循这个固定结构，
Contents/Home是硬编码约定，不是可选路径 -
/usr/libexec/java_home命令本身支持自动补全：/usr/libexec/java_home -v 21会直接输出带/Contents/Home的完整路径 - 如果你同时装了多个 JDK（比如 jdk-8、jdk-17、jdk-21），
/usr/libexec/java_home -V能帮你确认哪个版本对应哪条路径，避免手误选错
该往哪个 shell 配置文件里写 JAVA_HOME
macOS 默认 shell 已全面切换为 zsh（自 Catalina 起），所以优先改 ~/.zshrc；但很多旧脚本、IDE 或终端窗口仍可能读取 ~/.bash_profile，尤其当你用某些 IDE 内置终端或远程连接时。
最稳妥的做法是两个都写，且内容一致：
echo 'export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home' >> ~/.zshrc
echo 'export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home' >> ~/.bash_profile
- 不要只改一个文件然后靠
source测试——测试成功不代表所有场景都生效 - 改完后新开一个终端窗口验证，而不是只在当前 tab 里
source——有些 IDE 启动时只读一次 shell 配置 - 如果发现
echo $JAVA_HOME在终端里有值，但在 IntelliJ IDEA 的 Terminal 里为空，大概率是它没加载.zshrc，需要在 IDE 设置里勾选 “Shell integration” 或手动指定 shell 路径
PATH 里要不要加 $JAVA_HOME/bin？顺序有影响吗
必须加，而且必须放在 $PATH 开头（即 $JAVA_HOME/bin:$PATH），否则系统可能调用到系统自带的旧版 java（比如 macOS 自带的 Java 6 兼容层）。
典型错误配置：export PATH=$PATH:$JAVA_HOME/bin —— 这会让系统先查 /usr/bin/java，哪怕你装了 JDK 21，java -version 仍显示 1.6。
- 验证方式：运行
which java，输出应为/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home/bin/java，而不是/usr/bin/java -
CLASSPATH在现代 JDK（8+）和 Maven/Gradle 项目中基本不用手动设，删掉或注释掉更安全，避免干扰构建工具的类加载逻辑 - 不需要把
.加进PATH（即不要写:$PATH:.），这属于安全隐患，且对 JDK 使用毫无帮助
安装完 .dmg 包却找不到 java 命令，是不是没装好
不是安装失败，而是环境变量没生效，或者安装路径被系统拦截（常见于 macOS Sequoia 及更新版本对未签名二进制的限制）。
先确认 JDK 确实已落盘：
ls /Library/Java/JavaVirtualMachines/
如果看到类似 jdk-21.jdk 的目录，说明安装成功；如果为空，才是安装失败（可能被 Gatekeeper 阻止，需去“系统设置 > 隐私与安全性”里点“仍要打开”）。
- 若目录存在但
java -version报command not found，99% 是PATH没配对，重点检查$JAVA_HOME/bin是否在PATH开头、是否漏了export、是否改错了配置文件 - 若
java -version显示旧版本（如 1.8），说明有多个 JDK 共存，且默认选中了老版本——用/usr/libexec/java_home -V查清路径后，明确指定JAVA_HOME，再source配置 - 别依赖图形界面安装器“完成提示”，它不负责配置环境变量，那是你自己的事
/Library/Java/JavaVirtualMachines/ 下的目录名含版本号（如 jdk-21.0.4.jdk），但你复制路径时手抖少写了 .0.4，这种细微拼写错误不会报错，只会让 JAVA_HOME 指向一个不存在的路径，而终端也不会主动提醒——它只是安静地 fallback 到系统默认 Java。 
