JAVA_HOME必须指向JDK根目录（含bin、lib、jre子目录），而非bin或jre路径；PATH需包含%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（Linux/macOS）；修改后须重启终端或IDE并验证echo $JAVA_HOME、which java、which javac。
确认 JAVA_HOME 指向的是 JDK 根目录，不是 jre 或 bin
很多人把 JAVA_HOME 设成 C:\Program Files\Java\jdk-17.0.1\bin 或 ...\jre，这会导致 javac 找不到、Maven 报 Failed to parse JVM version 等问题。JDK 安装后，JAVA_HOME 必须指向包含 bin、lib、jre 三个子目录的顶层路径。
- 正确示例：
C:\Program Files\Java\jdk-17.0.1（Windows）或/usr/lib/jvm/java-17-openjdk-amd64（Linux） - 错误示例：
.../jdk-17.0.1/bin、.../jdk-17.0.1/jre、.../jre-17.0.1 - 验证方式：在终端运行
ls -l $JAVA_HOME（Linux/macOS）或dir %JAVA_HOME%（Windows），确认能看到bin目录
检查 PATH 是否包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Linux/macOS）
JAVA_HOME 配对生效的前提是 PATH 里有它的 bin 子目录。否则即使 JAVA_HOME 正确，java -version 和 javac -version 仍可能调用系统旧版本或报 command not found。
- Windows：确保
PATH中含%JAVA_HOME%\bin，且该条目位置靠前（避免被其他 Java 路径覆盖） - Linux/macOS：在
~/.bashrc或~/.zshrc中添加export PATH=$JAVA_HOME/bin:$PATH，然后执行source ~/.zshrc - 验证命令：
which java和which javac应输出$JAVA_HOME/bin/java类似路径
区分系统级和用户级环境变量，注意终端是否重启
Windows 修改“系统属性 → 高级 → 环境变量”后，已打开的 CMD/PowerShell 不会自动加载新变量；Linux/macOS 修改 shell 配置文件后，未 source 或新开终端也不会生效。这是最常被忽略的“配置写了但不生效”原因。
- Windows：关闭所有 CMD/PowerShell，重新打开再测试；若用 IDE（如 IntelliJ），需完全退出并重启
- Linux/macOS：改完
~/.zshrc后必须source ~/.zshrc；若用 GUI 应用（如 VS Code 图形版），可能需要注销重登录才能读取 shell 环境 - 验证是否生效：
echo $JAVA_HOME和echo $PATH要能打印出预期值，不能为空或旧路径
IDE 或构建工具（Maven/Gradle）可能绕过系统 JAVA_HOME
IntelliJ、Eclipse、VS Code Java Extension、Maven 的 settings.xml 都支持独立指定 JDK 路径，它们优先级高于系统环境变量。所以即使 JAVA_HOME 配对成功，项目仍可能编译失败或提示“Unsupported class file major version”。
- IntelliJ：File → Project Structure → Project → Project SDK，确认选中的是你刚配的 JDK
- Maven：检查
mvn -v输出的Java version和JAVA_HOME，若不一致，说明 Maven 用了内嵌 JDK 或MAVEN_OPTS覆盖了它 - Gradle：查看
gradle --version，同时检查项目根目录下是否有gradle.properties含org.gradle.java.home配置
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH
真正卡住的地方往往不是路径写错，而是变量没刷新、工具自作主张换了个 JDK、或者你以为改了全局其实只改了当前用户。多跑一遍 echo $JAVA_HOME 和 which javac，比反复重装 JDK 有用得多。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
