90%的“java -version不是内部或外部命令”是PATH未生效或被javapath劫持所致；执行where java可暴露真实路径顺序，须将%JAVA_HOME%\bin置顶、删除C:\Program Files\Common Files\Oracle\Java\javapath，并重启所有终端。
直接说结论：90% 的 java -version 报“不是内部或外部命令”，根本不是配置没做，而是 PATH 没生效、或被其他路径劫持了——尤其 Win11 下 MSI 安装包会偷偷往 PATH 里塞一个 C:\Program Files\Common Files\Oracle\Java\javapath，它优先级极高，且里面是旧版 java.exe 的硬链接，你改了 JAVA_HOME 它也完全无视。
where java 命令比 java -version 更能暴露真相
别急着重配环境变量，先打开 CMD 或 PowerShell，执行：
where java
它会按 PATH 顺序列出所有可执行的 java.exe。如果第一行不是你期望的 %JAVA_HOME%\bin\java.exe（比如指向 javapath 或旧 JDK），那问题就定位了。
- 出现
C:\Program Files\Common Files\Oracle\Java\javapath\java.exe：这是 Oracle MSI 安装器埋的“后门”，删不掉注册表，只能手动处理 - 出现多个路径：说明系统里残留了老 JDK，
PATH里有重复或冲突项 - 只返回空：说明
%JAVA_HOME%\bin根本没进PATH，或者JAVA_HOME路径本身写错了（比如结尾多了反斜杠、含中文、空格没加引号）
PATH 中 %JAVA_HOME%\bin 必须放在最前面
Win11 的 PATH 编辑界面默认是列表视图，但执行时仍严格从上到下扫描。一旦某条路径里有 java.exe，后面的所有路径就不再检查。
- 把
%JAVA_HOME%\bin拖到PATH列表的最顶端（不是末尾） - 绝对不要手写绝对路径如
C:\Java\jdk-21\bin—— 一旦重装 JDK，这个路径立刻失效 - 确认
JAVA_HOME变量值是纯路径，不含\bin，也不以\结尾（例如C:\Java\jdk-21✅，C:\Java\jdk-21\❌） - 如果
JAVA_HOME含空格（如C:\Program Files\Java\jdk-21），CMD 无法自动加引号，必须换到简单路径（推荐C:\Java\jdk-21）
MSI 安装 JDK 后必须清理 javapath
从 Oracle 官网下载的 .exe（其实是 MSI 封装）安装 JDK21/17/11 时，会静默创建并插入 javapath 到系统 PATH。这个目录下的 java.exe、javac.exe 是符号链接，指向注册表里记录的“默认 Java 版本”——跟你当前 JAVA_HOME 完全无关。
- 打开文件资源管理器，进入
C:\Program Files\Common Files\Oracle\Java\javapath - 右键删除该目录，或重命名为
javapath.bak - 如果提示“需要管理员权限”，就以管理员身份运行 CMD，执行：
rd /s /q "C:\Program Files\Common Files\Oracle\Java\javapath"
- 删完后，重启 CMD/PowerShell（不是关掉再开，是彻底关闭所有终端窗口再新开）
IDEA 或 VS Code 终端不认新 JDK？那是它们自己的 runtime 在捣鬼
java -version 在 CMD 里正常，但在 IDEA Terminal 里还是旧版本？这不是环境变量没配好，是 IDE 自己运行在一个固定 JDK 上，它的终端默认继承这个 runtime。
- IntelliJ IDEA：Help → About → 看
Runtime version，那是 IDEA 自身用的 JDK；项目 SDK 和 Terminal 是两套体系 - VS Code：终端启动时读的是父进程环境，不是系统最新变量；关掉所有窗口，从开始菜单重新启动 VS Code 才能加载新
PATH - Maven/Gradle 构建失败？检查
MAVEN_OPTS或 IDE 里 Maven 的 JRE 配置，它可能硬编码了旧路径
真正容易被忽略的点：环境变量修改后，所有已打开的 CMD、PowerShell、IDE、终端模拟器都不会自动刷新——它们启动时就固化了那一时刻的变量快照。哪怕你改了十次 PATH，不关掉重开，就永远看不到效果。
