答案是环境变量配置错误：JAVA_HOME未指向JDK根目录或PATH未正确添加%JAVA_HOME%\bin。需检查JAVA_HOME路径无空格/中文、不带\bin，PATH中含%JAVA_HOME%\bin且无冲突项，改后重启终端并用echo %JAVA_HOME%、where java、java -version验证。

直接执行 java -version 报“不是内部或外部命令”，说明系统根本找不到 java.exe，这不是版本问题，而是路径没通。核心就两点：JAVA_HOME 指向对不对，PATH 里有没有把它真正加进去。

检查 JAVA_HOME 是否指向 JDK 根目录

JAVA_HOME 必须是 JDK 安装的最外层文件夹，不能带 bin，也不能是 JRE 路径。比如正确的是：
C:\Java\jdk-17
错误的有：
C:\Java\jdk-17\bin（多了 \bin）
C:\Program Files\Java\jdk-17（含空格，CMD 解析易截断）
C:\软件\JDK\21（含中文，编码可能异常）

确认 PATH 中引用了 %JAVA_HOME%\bin

打开“环境变量”设置，找到系统级 Path，检查是否包含这一条：
%JAVA_HOME%\bin
不是绝对路径，不是 %JAVA_HOME%\jre\bin，也不是漏掉 % 的 JAVA_HOME\bin。还要注意：
- 这一条最好放在 Path 列表靠前位置，避免被其他 Java 路径覆盖
- 如果你用的是 MSI 安装包（常见于 Oracle 或某些 JDK21 版本），它会悄悄在 Path 里加一个：
C:\Program Files\Common Files\Oracle\Java\javapath
这个目录下是几个 .exe 的快捷方式，但容易指向旧版本或失效。建议删掉或重命名整个 javapath 文件夹。

验证与刷新必须做全

改完环境变量后：
- 关闭所有 CMD/PowerShell 窗口，重新打开一个全新的
- 先运行 echo %JAVA_HOME%，看输出是否和你设的一致
- 再运行 where java，它会列出所有能被找到的 java.exe。如果只返回一条且路径合理，说明 PATH 生效；如果没结果或返回了错误路径，就得回头再查
- 最后跑 java -version 和 javac -version，两个都成功才算完整可用

简化路径，避开常见陷阱

与其反复调试带空格、中文、深层嵌套的路径，不如重装一次到干净位置：
- 卸载当前 JDK
- 下载 ZIP 免安装版或选择自定义安装路径
- 安装到类似 C:\jdk21 或 D:\java\jdk-17 这样的路径
- 设置 JAVA_HOME = C:\jdk21，Path 加入 %JAVA_HOME%\bin
这样几乎能绕开 80% 的配置失败原因