JAVA_HOME必须指向JDK根目录而非JRE;需确认路径含“jdk”字样、bin目录下存在javac/javac.exe、PATH中正确配置%JAVA_HOME%\bin且无冲突,IDE须单独配置SDK路径。

检查 JAVA_HOME 是否指向 JDK 根目录而非 JRE
很多报错(比如 javac: command not found 或 IDE 提示“no JDK specified”)根源在于 JAVA_HOME 指向了 C:\Program Files\Java\jre1.8.0_XXX 这类 JRE 路径,而不是 jdk1.8.0_XXX。JDK 必须包含 bin/javac.exe,JRE 没有。
- 在命令行运行
echo %JAVA_HOME%(Windows)或echo $JAVA_HOME(macOS/Linux),确认路径末尾是jdkX.X.X_XX - 进入该路径,手动检查是否存在
bin/javac(Linux/macOS)或bin/javac.exe(Windows) - 若用的是 Oracle JDK 从官网下载的压缩包,解压后路径里必须含
jdk字样;OpenJDK 官方构建通常也带jdk-前缀
验证 PATH 中是否重复或错误拼接了 %JAVA_HOME%\bin
PATH 配置错误会导致系统调用 java 成功但 javac 失败,或者反过来——因为可能 PATH 里混入了旧版 JRE 的 bin,优先级更高。
- 运行
where java(Windows)或which java(macOS/Linux),再运行where javac,两者输出路径应完全一致且属于同一 JDK 安装目录 - 如果
java来自C:\Windows\System32,说明 Windows 自带的旧版java.exe干扰了,需从 PATH 中移除该目录或确保%JAVA_HOME%\bin排在最前 - 避免在 PATH 中硬编码路径(如
C:\Program Files\Java\jdk-17\bin),改用%JAVA_HOME%\bin,便于后续切换版本
IDE(IntelliJ / Eclipse)中显示 “No SDK” 或编译器版本不匹配
IDE 不读取系统环境变量的 JAVA_HOME,它依赖自身配置的 SDK 路径。即使命令行 javac -version 正确,IDE 仍可能用错 JDK。
- IntelliJ:File → Project Structure → Platform Settings → SDKs,确认已添加且路径指向 JDK 根目录(不是
bin子目录),并勾选对应 SDK 为 Project SDK - Eclipse:Preferences → Java → Installed JREs,点击 Add → Standard VM → Next,Directory 选择 JDK 根目录(例如
C:\jdk-17.0.1),不能选到bin或jre子目录 - 新建项目时若默认用了 JRE,需右键项目 → Properties → Java Build Path → Libraries → 删除 JRE System Library,再 Add Library → JRE System Library → Alternate JRE
运行 java -version 和 javac -version 输出版本不一致
这是典型 PATH 混乱信号。说明 java 和 javac 来自不同安装位置,极可能导致编译通过但运行失败(如使用了新语法却在旧 JVM 上执行)。
立即学习“Java免费学习笔记(深入)”;
- 分别执行
java -version和javac -version,注意输出中的 build number(如17.0.1+12-LTS-39),必须完全一致 - 检查是否安装了多个 JDK(如同时有 Adoptium、Amazon Corretto、Oracle JDK),不同厂商的同版本号实际 ABI 可能不兼容
- Windows 用户尤其注意:PowerShell 和 CMD 的环境变量可能不同步,建议统一在 CMD 中测试,并重启终端后再验证
JAVA_HOME 错、PATH 乱、IDE 独立加载、终端未刷新,四者任一环节断开,都会让整个 Java 工具链表现异常。










