Java环境变量配置失败本质是系统找不到java/javac，需逐层验证：先直调JDK路径确认安装完好；再查JAVA_HOME是否指向JDK根目录（不含bin）；接着验证PATH中%JAVA_HOME%\bin是否生效且优先；最后确保新配置已加载到当前会话。
Java环境变量配置失败，本质是系统找不到java和javac这两个关键命令。不是“没配”，而是“配了但没被正确读取或调用”。排查要从底层可执行性出发，一层层验证，不跳步。
第一步：绕过环境变量，直接验证JDK是否真能用
别急着查PATH，先确认JDK本身没问题：
- Windows：在CMD中输入带引号的完整路径，例如：
"C:\Program Files\Java\jdk-17\bin\java.exe" -version（含空格必须加引号） - macOS/Linux：运行类似
/opt/jdk-17.0.2/bin/java -version（替换为你的真实安装路径） - 如果输出版本号，说明JDK安装完好；如果报“找不到文件”或“权限拒绝”，说明路径错、安装损坏，或路径含中文/空格导致解析失败
第二步：检查JAVA_HOME是否指向正确的JDK根目录
这是整个链条的起点，错一点全盘失效：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 值必须是JDK安装的根目录，不能带
\bin，也不能以反斜杠结尾（C:\java\jdk-17✅，C:\java\jdk-17\❌） - 不能指向JRE（如
C:\Program Files\Java\jre1.8.0），必须是包含bin、lib、jre子目录的JDK文件夹 - Windows中不要加英文引号；Linux/macOS在
~/.zshrc或~/.bashrc中写成：export JAVA_HOME=/opt/jdk-17
第三步：确认PATH中%JAVA_HOME%\bin是否生效且位置靠前
PATH决定系统“先找谁”，顺序就是权力：
立即学习“Java免费学习笔记（深入）”；
- Windows：打开环境变量编辑器，确保
%JAVA_HOME%\bin是一条独立条目，并排在所有其他Java相关路径（尤其是C:\Program Files (x86)\Common Files\Oracle\Java\javapath）之前 - macOS/Linux：运行
echo $PATH，确认$JAVA_HOME/bin出现在最左侧；写法应为：export PATH=$JAVA_HOME/bin:$PATH - 执行
where java（Windows）或which java（macOS/Linux）——结果才是你真正调用的java，不是你以为的那个
第四步：确保新配置已加载到当前会话
改了≠生效，系统不会自动广播更新：
- Windows：关闭所有CMD/PowerShell窗口，新开一个；IDE（如IntelliJ）需完全退出再启动，桌面图标启动的IDE不继承终端环境变量
- macOS/Linux：改完
~/.zshrc后必须运行source ~/.zshrc；用echo $SHELL确认当前shell类型，别改错文件（macOS Catalina后默认zsh，改.bashrc无效） - VS Code内置终端可能不触发login shell，建议在设置中启用并重启终端
