Java环境配置不稳的核心原因是路径错误、未生效、被覆盖或多版本冲突；须严格做到四点：JAVA_HOME精准指向JDK根目录（非JRE或bin）、PATH显式包含%JAVA_HOME%\bin、每次修改后重开终端及IDE、验证java/javac版本与where java路径三者一致。
Java 环境变量配不稳，不是没配，而是“配得不牢”——路径错、没生效、被覆盖、多版本打架。避开绝大多数坑，盯住四个关键动作就行。
路径必须真实存在且指向 JDK 根目录
JAVA_HOME 不是随便复制一个文件夹路径就行，它必须精准指向你安装的 JDK 完整根目录（不是 JRE，也不能带 \bin）。
- ✅ 正确示例：
C:\Java\jdk-17.0.2（Windows）、/opt/homebrew/opt/openjdk@17（macOS）、/usr/lib/jvm/java-17-openjdk-amd64（Linux） - ❌ 常见错误：路径末尾多了
\bin；选成了C:\Program Files\Java\jre1.8.0_301；路径含空格又没处理（Windows 建议改用无空格路径，如D:\Java\jdk-17） - 验证方法：命令行输入
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），输出必须和你手动打开资源管理器/访达后看到的真实文件夹路径完全一致
PATH 必须显式包含 %JAVA_HOME%\bin 或 $JAVA_HOME/bin
只设 JAVA_HOME 是不够的，系统靠 PATH 找命令。PATH 里必须有一条明确指向 JDK 的 bin 目录。
- Windows：在系统环境变量 Path 中新增一条
%JAVA_HOME%\bin（不要手输完整路径，避免升级 JDK 后失效） - macOS/Linux：在
~/.zshrc中添加两行：export JAVA_HOME=$(/usr/libexec/java_home -v 17)export PATH=$JAVA_HOME/bin:$PATH - ⚠️ 关键细节：新路径尽量放 PATH 最前面，否则旧 JDK 路径可能优先命中；修改后必须
source ~/.zshrc（macOS/Linux）或重启终端（Windows）
每次修改都重开终端 + 重启 IDE
环境变量不是改完就自动刷新。已打开的 CMD、PowerShell、Terminal、VS Code 内置终端、IDEA 都不会读取新配置。
立即学习“Java免费学习笔记（深入）”；
- Windows：关掉所有命令行窗口，再新开一个；运行
echo %PATH%确认新路径已出现 - macOS/Linux：关闭终端重开，或执行
source ~/.zshrc - IDE（IntelliJ、VS Code、Eclipse）：必须完全退出再启动，否则仍沿用旧环境变量
验证要同步看三个结果
别只敲 java -version 就以为万事大吉。真正有效的配置，三者必须一致：
-
java -version和javac -version输出的版本号必须完全相同 -
where java（Windows）或which java（macOS/Linux）返回的路径，必须是%JAVA_HOME%\bin\java.exe或$JAVA_HOME/bin/java，不能是C:\Windows\System32\java.exe这类系统残留 - 如果项目用 Maven/Gradle，也建议跑一次
mvn -v，确认它调用的也是同一个 JDK
