根本原因是PATH未包含%JAVA_HOME%\bin且终端未刷新：需显式将JDK的bin目录加入PATH，并关闭所有旧终端后新开窗口验证，同时用where java排查路径冲突。
配置完 Java 环境变量后命令行仍提示“java 不是内部或外部命令”，根本原因不是 JDK 没装好，而是系统在当前终端会话中压根没“看见”你刚设的路径。这属于环境变量加载机制和配置细节共同作用的结果，不是玄学，但容易漏掉关键一环。
PATH 里没真正加上 JDK 的 bin 目录
很多人只设置了 JAVA_HOME，却忘了把 %JAVA_HOME%\bin（Windows） 或 $JAVA_HOME/bin（macOS/Linux） 显式加进 PATH。JAVA_HOME 只是个“地址标签”，PATH 才是系统实际翻找命令的“路线图”。如果 PATH 里没有这个 bin 路径，系统就完全不会去 JDK 文件夹里找 java.exe 或 java。
- Windows：检查 PATH 变量值中是否包含类似
C:\Program Files\Java\jdk-21\bin或%JAVA_HOME%\bin的条目 - macOS/Linux：运行
echo $PATH，确认输出里有/path/to/jdk/bin这样的完整路径 - 特别注意：如果用
$JAVA_HOME/bin，必须用双引号包裹（如export PATH="$JAVA_HOME/bin:$PATH"），否则含空格路径会解析失败
终端没刷新，旧会话不认新配置
环境变量修改后不会自动同步到已打开的终端窗口。所有正在运行的 CMD、PowerShell、Terminal 都是在配置前就启动的，它们读取的是旧的环境快照。
- 必须关闭所有已打开的命令行窗口，再全新打开一个
- 不要用“重新运行”或“新建标签页”代替——有些终端标签页仍继承旧环境
- 验证时先执行
echo %JAVA_HOME%（Win）或echo $JAVA_HOME（macOS/Linux），确保变量值正确，再试java -version
PATH 中存在干扰项或优先级错乱
PATH 是从左到右搜索的。如果前面已有其他 java 可执行文件（比如 Windows 的 C:\Windows\System32\java.exe），哪怕你配了 JDK 的 bin，系统也会优先用那个旧的、甚至只是 JRE 的版本。
立即学习“Java免费学习笔记（深入）”；
- Windows 下运行
where java，看返回的第一条路径是不是你 JDK 的 bin 目录 - macOS/Linux 运行
which java和ls -l $(which java)，确认软链接指向正确 JDK - 若发现冲突，可将 JDK 的 bin 路径移到 PATH 最前面（Windows 编辑时拖到顶部；Linux 在 export 中写成
export PATH="/your/jdk/bin:$PATH"）
用户级 vs 系统级配置没对上号
你在“系统变量”里配了 JAVA_HOME 和 PATH，但打开的是普通 CMD ——它默认只读“用户变量”。反过来，如果你只在用户变量里配了，又用管理员模式运行终端或 IDE，也可能读不到。
- 日常开发建议统一配在“用户变量”里，避免权限问题
- 配完后，在同一类终端（比如都用普通 CMD，或都用非 sudo 的 Terminal）中验证
- IDE（如 IDEA）有时自带 JDK 配置，能跑不代表命令行能跑，两者环境是独立的
