最典型症状是命令行输入java -version或javac -version提示“不是内部或外部命令”；需依次确认JDK安装路径正确、JAVA_HOME精准指向根目录无多余字符、PATH包含%JAVA_HOME%in且位置靠前，最后通过java/javac/echo三命令交叉验证。
环境变量配置出错，最典型的症状就是命令行敲 java -version 或 javac -version 时提示“不是内部或外部命令”。这不是Java坏了，而是系统根本没找到它——排查要从路径查找逻辑一层层往下压。
第一步：确认JDK是否真的装对了位置
很多人点完安装向导就以为结束了，但JDK可能被装进了JRE目录、用户目录，甚至桌面文件夹里。打开文件管理器，手动去找真正的JDK根目录：
- Windows 默认路径是 C:Program FilesJavajdk-17（或 jdk-21、jdk-8 等），注意结尾不能是
jdk-17in，也不能是jre-17； - macOS 路径通常是 /Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home；
- Linux 常见路径为 /usr/lib/jvm/jdk-17 或通过
sudo update-alternatives --config java查看真实路径。
如果找不到带 javac.exe（Windows）或 javac（macOS/Linux）的 bin 子目录，说明JDK没装好或装错了地方，先重装并记下确切路径。
第二步：检查 JAVA_HOME 是否指向根目录且无多余字符
JAVA_HOME 是“指针”，必须精准指向 JDK 安装根目录，不能多也不能少：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- 路径中不要加引号，比如
"C:Program FilesJavajdk-17"是错的，应写成C:Program FilesJavajdk-17； - 结尾不要加反斜杠，
C:Javajdk-17和%JAVA_HOME%in拼起来会变成C:Javajdk-17\bin，某些工具会拒绝识别； - 路径中避免中文、空格过多（如
C:我的开发jdk），容易引发编码或截断问题； - 验证方法：新开一个命令行窗口，输入
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），输出必须和你手动查到的路径完全一致。
第三步：PATH 里是否正确引用了 %JAVA_HOME%in
PATH 是系统找命令的“路线图”，它不认 JAVA_HOME 这个名字，只认展开后的实际路径：
- Windows PATH 中应包含
%JAVA_HOME%in，而不是硬写成C:Program FilesJavajdk-17in（后者迁移性差，且空格易出错）； - 确保这个条目在 PATH 列表中靠前，尤其要排在旧版 Java（如 jdk1.8）或 JRE 的路径前面，否则系统会优先用老版本；
- 修改后务必关闭所有已打开的 CMD/PowerShell/IDE，再新开一个窗口测试，旧窗口不会自动刷新环境变量；
- 验证方法：在新命令行中运行
where java（Windows）或which java（macOS/Linux），输出的第一行路径应是%JAVA_HOME%injava.exe对应的实际位置。
第四步：交叉验证三组命令是否全部通过
单靠 java -version 成功不代表 javac 可用，必须三项全通才算真正配好：
-
java -version→ 检查 JRE 运行环境； -
javac -version→ 检查 JDK 编译器是否存在（这才是开发关键）； -
echo %JAVA_HOME%或echo $JAVA_HOME→ 确认变量本身已加载且值正确。
如果前两个失败但第三个成功，说明 PATH 没加对；如果三个都显示正常但 IDE 仍报 “No JDK found”，那问题大概率出在 IDE 自己的 SDK 设置里，而非系统环境变量。
