JAVA_HOME必须指向JDK根目录，如C:\Program Files\Java\jdk-17.0.1或/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home；需同时将%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）加入PATH前端，并验证which java输出是否匹配$JAVA_HOME/bin/java。
JAVA_HOME 指向哪个目录才对
它必须指向 JDK 的根目录，不是 bin，不是 jre，更不是 jdk-xx/bin/java。常见错误是配成 C:\Program Files\Java\jdk-17.0.1\bin —— 这会导致几乎所有依赖 JAVA_HOME 的工具（Maven、Gradle、IDEA、Tomcat）直接报“找不到 Java”或“not a valid JDK”。正确路径示例：C:\Program Files\Java\jdk-17.0.1（Windows）或 /Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home（macOS）。
验证方法：在终端执行 echo $JAVA_HOME（Linux/macOS）或 echo %JAVA_HOME%（Windows），再确认该路径下存在 bin/java 和 lib/tools.jar（JDK 9+ 可能没有 tools.jar，但必须有 bin/javac）。
PATH 里要不要再加 %JAVA_HOME%\bin
要，而且这是关键一步。只设 JAVA_HOME 不加 bin 到 PATH，命令行敲 java 或 javac 依然会提示“命令未找到”。
- Windows：在系统环境变量
PATH中追加%JAVA_HOME%\bin（注意用英文百分号，且不要有多余空格） - macOS/Linux：在
~/.zshrc或~/.bash_profile中添加export PATH=$JAVA_HOME/bin:$PATH - 顺序很重要：确保
$JAVA_HOME/bin在PATH前段，否则可能被系统自带的 OpenJDK 或旧版本覆盖
多个 JDK 共存时 JAVA_HOME 怎么切
不能靠“安装新 JDK 自动切换”，JAVA_HOME 是静态环境变量，改了就得手动重载或重启终端/IDE。实际开发中常需来回切 JDK 8 / 11 / 17，硬编码不现实。
推荐做法：
- Windows：写几个批处理脚本，比如
use-jdk11.bat内容为set JAVA_HOME=C:\jdk-11.0.2 & set PATH=%JAVA_HOME%\bin;%PATH%，双击运行即可临时切换 - macOS/Linux：用函数封装，例如在
~/.zshrc里加jdk8() { export JAVA_HOME=$(/usr/libexec/java_home -v 1.8); export PATH=$JAVA_HOME/bin:$PATH; }，之后终端输入jdk8就生效 - IDE（IntelliJ / Eclipse）必须单独配置 SDK，它们不读系统
JAVA_HOME来编译项目 —— 这是高频盲点
为什么 java -version 和 echo $JAVA_HOME 显示不一致
说明当前 shell 用的 java 不是从 $JAVA_HOME/bin 来的，而是 PATH 中更靠前的另一个 Java。典型场景：
- macOS 自带
/usr/bin/java（其实是代理，指向/Library/Java/JavaVirtualMachines/...），即使你改了JAVA_HOME，只要它在PATH里排前面，java -version就显示那个 - Homebrew 安装的 OpenJDK 默认加到
/opt/homebrew/bin，而该路径常被加在PATH开头 - 检查真实调用链：运行
which java和ls -l $(which java)，看它到底链接到哪
修复思路永远是：先确认 which java 输出是否等于 $JAVA_HOME/bin/java，不等就调整 PATH 顺序，而不是反复重装 JDK。
真正麻烦的从来不是设一次 JAVA_HOME，而是不同工具链对它的读取时机和优先级各不相同 —— Maven 看系统变量，Gradle 可能继承 IDE 环境，Docker 构建又是一套隔离空间。配完记得在每个使用场景里单独验证。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
