核心是系统找不到java或javac：1. JAVA_HOME须指向JDK根目录（含bin/lib），不能是JRE或带空格路径；2. Path必须包含%JAVA_HOME%\bin；3. 修改后需新开终端验证java/javac -version；4. 注意IDE、多版本、Shell差异等干扰项。
Java 环境变量配置错误，核心就一件事：系统找不到 java 或 javac 这两个可执行文件。问题不在代码，而在路径和变量是否真正“被系统认出来”。下面分四步直击关键点，不绕弯。
确认 JAVA_HOME 是否指向正确的 JDK 根目录
JAVA_HOME 必须是 JDK 安装的最外层文件夹，里面要有 bin、lib、jre 这些子目录。不是 bin，也不是 jre，更不能是带中文或空格的路径（如 C:\Program Files\Java\jdk-17 容易出错）。
- 在 CMD 中运行：
echo %JAVA_HOME%—— 看输出是否为空、是否含中文/空格/多余反斜杠 - 手动打开该路径，检查是否存在
bin\java.exe和lib\tools.jar（后者是 JDK 的标志，JRE 没有） - 推荐做法：把 JDK 装到简洁路径，比如
C:\jdk\jdk-17，再设JAVA_HOME=C:\jdk\jdk-17
检查 Path 是否包含 %JAVA_HOME%\bin
只设 JAVA_HOME 不够，系统还得知道去哪找命令。Path 里必须有一条明确引用它的路径，且不能写死、不能漏掉 \bin。
- 打开系统环境变量 → 编辑 Path → 查看是否有
%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux） - 避免直接写
C:\Program Files\Java\jdk-17\bin—— 升级或重装就失效 - 确保这条路径排在其他 Java 相关路径前面（比如 Android Studio 自带的 JDK），否则可能调用错版本
验证配置是否真正生效
改完环境变量，旧终端不会自动更新。必须新开一个 CMD 或终端窗口，再测试：
- 输入
java -version和javac -version—— 两者都应显示相同版本号 - 若只有
java成功、javac报错，说明 Path 没加对\bin，或 JAVA_HOME 指向了 JRE - 输入
where java（Windows）或which java（macOS/Linux）—— 看实际调用的是哪个路径下的 java
排查隐藏干扰项
有些问题看似环境变量没配好，其实是被其他机制覆盖了：
- Hadoop、Spark 等工具自带
hadoop-env.cmd或spark-env.sh，会重新设置 JAVA_HOME，优先级高于系统变量 - IDE（如 IntelliJ、Eclipse）内部设置了独立 JDK，可能掩盖系统配置问题；要以纯 CMD 运行为准
- Git Bash、WSL、PowerShell 可能读取不同配置文件（如
~/.bashrc），和 Windows 系统变量无关，需单独配置 - 管理员身份运行 CMD 时，若环境变量只设在“用户变量”，它可能读不到；建议统一设为“系统变量”
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
