JAVA_HOME必须严格指向JDK根目录（含bin、lib、jre子目录），不可指向bin或JRE；常见错误包括末尾多加\bin、误用JRE路径、含空格未妥善处理；验证需同时检查echo %JAVA_HOME%和javac -version。
JAVA_HOME 路径必须严格指向 JDK 根目录
它要包含 bin、lib、jre 这些子文件夹，不能多写也不能少写。常见错误是路径末尾加了 \bin，比如写成 C:\Program Files\Java\jdk-21\bin——这会让 javac 找不到 tools.jar；也别误选 JRE 目录，里面根本没有编译器。
验证方法：在命令行运行 echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（macOS/Linux），再手动打开该路径，确认里面真有 bin\javac.exe 或 bin/javac 文件。
空格路径要绕开，别硬扛
Windows 默认的 Program Files 带空格，很多旧工具解析会断裂。不建议在环境变量里直接写带空格的长路径，更不要加英文双引号——系统会把引号当路径一部分，导致失败。
- 推荐做法：重装 JDK 时手动指定无空格路径，例如
D:\jdk-21或C:\dev\jdk21 - 如果已装在含空格路径，可用 Windows 的 8.3 短名替代，如
C:\PROGRA~1\Java\jdk-21（用dir /x命令查真实缩写） - Linux/macOS 下若路径含空格，必须在外层加双引号定义变量，例如
export JAVA_HOME="/opt/my jdk"，并在调用时也带引号："$JAVA_HOME/bin/java"
PATH 中引用变量比写死路径更可靠
PATH 里不要直接填 C:\Program Files\Java\jdk-21\bin，而应填 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）。这样只要 JAVA_HOME 正确，PATH 就不会因路径变动或拼写微小差异而失效。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
检查点：
– Windows 下确认 PATH 项中没有多余分号（末尾的 ; 会被当作空路径，导致后续所有路径被忽略）
– Linux/macOS 下确保配置写在 ~/.bashrc 或 ~/.zshrc，并执行 source ~/.zshrc 生效
验证时别只看 java，要同步查 javac
java -version 成功不代表环境配对了——可能只是系统自带 JRE 在起作用。必须同时运行：javac -version —— 验证编译器是否可用where javac（Windows）或 which javac（macOS/Linux）—— 看它实际来自哪个路径echo %JAVA_HOME% 和 echo %PATH% —— 确认变量值和顺序都符合预期
如果 java 和 javac 版本不一致，说明 PATH 里混入了多个 JDK，要把 %JAVA_HOME%\bin 放到 PATH 最前面。
