“不是内部或外部命令”本质是系统未找到java.exe，需先用where java定位路径：若无输出则path未配置；若首行为oracle伪装路径则优先级冲突；若含空格/中文路径会导致解析失败；务必清理旧jdk硬编码路径、以管理员权限安装配置、重启终端生效。

java -version 报“不是内部或外部命令”？先查 where java

这不是环境变量没配，而是系统根本没找到 java.exe。别急着重配，先运行：
where java
它会按 PATH 查找顺序列出所有匹配路径。如果输出为空，说明 PATH 里压根没加对；如果第一行是 C:\Program Files\Common Files\Oracle\Java\javapath\java.exe，那问题就明确了——Oracle 安装器偷偷塞了个高优先级路径，盖过了你手动配的 %JAVA_HOME%\bin。

• 必须关掉所有旧 CMD/PowerShell 窗口，新开一个再执行 where java，否则看到的是旧环境
• 若输出包含多个路径，检查第一个是否指向你期望的 JDK bin 目录；不是就说明顺序错了
• 若输出只有 javaw.exe 或根本没 java.exe，可能是安装包损坏或解压不完整（尤其 ZIP 版），重装或校验 SHA256

JAVA_HOME 路径里有空格或中文？立刻改掉

Windows 的 PATH 解析在遇到带空格路径时，会把 C:\Program Files\Java\jdk-17 拆成 C:\Program 和 Files\Java\jdk-17 两段，导致 %JAVA_HOME%\bin 展开失败。中文同理，JVM 类加载器底层用 UTF-8，而 Windows 控制台默认 GBK，一读就乱码报 ClassNotFoundException。

博特妙笔

一款面向公职人员公文写作的AI辅助平台，结合公文查询、写作、审核和学习等功能，帮助提升规范材料处理效率。

下载

• 推荐路径：直接用 C:\Java\jdk-17 或 D:\jdk\17，全英文、无空格、无括号
• 不要写成 C:\Program Files\Java\jdk-17\（结尾斜杠）或 C:/Java/jdk-17（正斜杠）
• 配置完后，在 CMD 里执行 echo %JAVA_HOME%，确认输出和你设置的一致，且不含多余字符

Path 里混着旧版本硬编码路径？删干净再配

很多人之前装过 JDK 8，Path 里留着 C:\Program Files\Java\jdk1.8.0_381\bin。后来装了 JDK 17，只改了 JAVA_HOME，但 Path 里老路径还在，而且排在新路径前面——系统永远优先调用老版本。

• 打开“环境变量”→编辑 Path→逐条检查，删掉所有明确写死的 JDK 路径（如含 jdk1.8、jdk-11 字样的）
• 只保留 %JAVA_HOME%\bin 这一条动态引用，避免版本升级后又要手动改 Path
• 如果必须多版本共存，用 set JAVA_HOME=... 临时切换，而不是在 Path 里堆砌多个 %JAVA_HOME_x%\bin

管理员权限没到位，安装和配置都白干

JDK 安装器默认写注册表和系统环境变量，Win11 的 UAC 会拦截非管理员操作。常见现象：安装完成提示“成功”，但 JAVA_HOME 变量根本没出现在系统变量里，或者 Path 里少了 %JAVA_HOME%\bin。

• 安装 JDK 时，务必右键 .exe 文件 → “以管理员身份运行”
• 配置环境变量时，也建议用管理员权限打开“系统属性”→“环境变量”，避免只改了用户变量而漏掉系统变量
• 验证前，用管理员权限打开 CMD，执行 java -version，排除权限干扰

实际操作中最容易被忽略的，是终端进程的环境继承机制——Windows 不会热更新已运行进程的环境变量，哪怕你点了一百次“确定”，旧窗口里的 java 命令仍调用旧路径。关掉所有终端，从开始菜单重新启动 CMD 或 PowerShell，这是唯一可靠的做法。