最后更新：2026-06-11
适用系统：Windows 10 / Windows 11
适用场景：javac 不是内部或外部命令、java 正常但 javac 不正常、JDK 环境变量配置错误、JAVA_HOME 配置不生效、Path 中 Java 路径错误
在 Windows 上安装 Java 后，很多人执行：
javac -version
会遇到下面这个错误：
'javac' 不是内部或外部命令，也不是可运行的程序或批处理文件。
或者英文系统显示：
'javac' is not recognized as an internal or external command,
operable program or batch file.
这个问题非常常见，尤其是刚安装 JDK、配置 JAVA_HOME、切换多个 JDK 版本时。
先说结论：javac 找不到，通常不是 Java 安装失败，而是当前系统没有找到 JDK 的 bin 目录。
常见原因包括：
只安装了 JRE，没有安装 JDK
JAVA_HOME 指向了错误目录
Path 没有添加 %JAVA_HOME%\bin
Path 中旧 Java 路径排在前面
命令行窗口没有重新打开
安装目录选错了
IDEA / Maven 使用了另一个 JDK
如果你还没有安装 JDK，可以先看：
Windows安装JDK 8 / 17 / 21 / 25完整教程：JAVA_HOME环境变量配置与验证
一、先说结论：javac 是 JDK 里的编译器
javac 是 Java 编译器，用来把 .java 源码编译成 .class 字节码文件。
例如：
javac HelloWorld.java
编译后会生成：
HelloWorld.class
所以，javac 来自 JDK 的 bin 目录。
例如 JDK 安装在：
D:\Java\jdk-17
那么 javac.exe 应该在：
D:\Java\jdk-17\bin\javac.exe
如果系统找不到这个文件，就会报：
javac 不是内部或外部命令
二、先检查 java 和 javac 是否都正常
打开新的 CMD 或 PowerShell，执行：
java -version
再执行：
javac -version
可能会出现几种情况。
| java -version | javac -version | 说明 |
|---|---|---|
| 正常 | 正常 | JDK 配置基本正常 |
| 正常 | 报错 | 可能只配置了 Java 运行环境，没找到 JDK 编译器 |
| 报错 | 报错 | Java 环境变量整体没有配置好 |
| 显示旧版本 | 显示新版本 | Path 中 Java 路径混乱 |
| 显示新版本 | 显示旧版本 | java 和 javac 来自不同 JDK |
最理想的结果是：
java -version 显示 JDK17
javac -version 显示 JDK17
或者：
java -version 显示 JDK21
javac -version 显示 JDK21
二者版本应该一致。
三、用 where 命令查看 javac 实际路径
在 CMD 中执行：
where javac
PowerShell 中建议执行：
where.exe javac
如果配置正常，输出类似：
D:\Java\jdk-17\bin\javac.exe
如果提示：
信息: 用提供的模式无法找到文件。
说明系统当前 Path 中找不到 javac.exe。
再执行：
where java
正常应该类似：
D:\Java\jdk-17\bin\java.exe
如果 where java 有结果，但 where javac 没结果，通常是下面几种情况：
1. 当前 java.exe 不是来自完整 JDK
2. Path 指向了 JRE 或 Oracle javapath
3. JAVA_HOME 配置错误
4. Path 没有正确添加 %JAVA_HOME%\bin
四、检查是否安装了 JDK，而不是 JRE
开发 Java 项目必须安装 JDK。
JDK 包含：
java
javac
jar
javadoc
jdb
keytool
而 JRE 主要用于运行 Java 程序，不适合用来开发和编译 Java 项目。
你可以进入 JDK 安装目录，查看是否有：
bin\javac.exe
例如：
D:\Java\jdk-17\bin\javac.exe
如果没有 javac.exe，说明你当前目录不是完整 JDK。
解决办法：
重新下载并安装 JDK，不要只安装 JRE。
推荐下载 JDK，而不是 JRE：
Package Type: JDK
如果你不知道去哪里下载，可以看：
各版本JDK镜像下载地址：JDK8 / JDK11 / JDK17 / JDK21 / JDK25 / JDK26 下载与IDEA配置指南
五、检查 JAVA_HOME 是否正确
在 CMD 中执行：
echo %JAVA_HOME%
PowerShell 中执行：
echo $env:JAVA_HOME
正确输出应该是 JDK 根目录，例如：
D:\Java\jdk-17
或者：
D:\Java\jdk-21
错误写法一：
D:\Java\jdk-17\bin
错误写法二：
D:\Java\jdk-17;
错误写法三：
"D:\Java\jdk-17"
注意：JAVA_HOME 应该指向 JDK 根目录，不是 bin 目录。
正确：
JAVA_HOME=D:\Java\jdk-17
Path 中再添加：
%JAVA_HOME%\bin
六、检查 Path 是否包含 %JAVA_HOME%\bin
打开环境变量：
此电脑 > 右键 > 属性 > 高级系统设置 > 环境变量
或者开始菜单搜索：
环境变量
找到：
系统变量 > Path
检查是否有这一项：
%JAVA_HOME%\bin
如果没有，就新增一行：
%JAVA_HOME%\bin
不要只配置 JAVA_HOME，还必须让 Path 能找到 JDK 的 bin 目录。
推荐配置：
JAVA_HOME = D:\Java\jdk-17
Path = %JAVA_HOME%\bin
不推荐直接写死：
D:\Java\jdk-17\bin
虽然这样也能用，但以后切换 JDK 时还要改 Path。更好的方式是只改 JAVA_HOME。
七、修改环境变量后要重新打开命令行
修改 Windows 环境变量后，已经打开的 CMD、PowerShell、Windows Terminal、IDEA Terminal 不一定会立即生效。
所以你改完后，要这样做：
1. 关闭所有 CMD / PowerShell / Windows Terminal
2. 重新打开一个新的命令行窗口
3. 执行 java -version
4. 执行 javac -version
5. 执行 where javac
如果是在 IDEA 里的 Terminal 中测试，也建议：
关闭 IDEA Terminal
重新打开 Terminal
必要时重启 IDEA。
一般不需要重启电脑，但如果你改完很多次仍然不生效，可以最后再重启系统。
八、Path 里旧 Java 路径可能影响 javac
如果你以前安装过 JDK8、Oracle JDK、JRE，Path 里可能有旧路径。
常见旧路径：
C:\Program Files\Common Files\Oracle\Java\javapath
C:\Program Files\Java\jdk1.8.0_xxx\bin
C:\Program Files\Java\jre1.8.0_xxx\bin
这些路径如果排在：
%JAVA_HOME%\bin
前面，就可能导致系统先找到旧版本 Java。
执行：
where java
where javac
如果输出类似：
C:\Program Files\Common Files\Oracle\Java\javapath\java.exe
D:\Java\jdk-17\bin\java.exe
说明 Oracle 的 javapath 抢在前面了。
建议处理：
1. 打开系统 Path
2. 找到旧 Java 路径
3. 删除或移动到 %JAVA_HOME%\bin 后面
4. 确保 %JAVA_HOME%\bin 排在前面
5. 保存后重新打开命令行
理想情况是：
where java
D:\Java\jdk-17\bin\java.exe
where javac
D:\Java\jdk-17\bin\javac.exe
九、java 正常但 javac 不正常怎么办？
这是最常见的情况。
例如：
java -version
正常：
java version "1.8.0_361"
但：
javac -version
报错：
javac 不是内部或外部命令
常见原因：
1. 当前 java 来自 JRE
2. Path 中只有 java.exe 的路径，没有 javac.exe
3. JAVA_HOME 指向了错误目录
4. Oracle javapath 中没有正确的 javac
5. 没安装完整 JDK
解决顺序：
1. 确认 JDK 目录中有 bin\javac.exe
2. 设置 JAVA_HOME 到 JDK 根目录
3. Path 添加 %JAVA_HOME%\bin
4. 删除或下移旧 Java 路径
5. 重新打开命令行
6. 执行 where java 和 where javac
十、java 和 javac 版本不一致怎么办？
有时会出现：
java -version -> 1.8.0_xxx
javac -version -> 17.0.x
或者：
java -version -> 17.0.x
javac -version -> 1.8.0_xxx
这说明 java.exe 和 javac.exe 来自不同目录。
执行：
where java
where javac
如果看到类似：
where java
C:\Program Files\Common Files\Oracle\Java\javapath\java.exe
D:\Java\jdk-17\bin\java.exe
where javac
D:\Java\jdk-17\bin\javac.exe
那就是 Path 顺序混乱。
解决办法：
1. Path 中只保留 %JAVA_HOME%\bin
2. 删除或下移旧 Java 路径
3. 重新打开命令行
4. 再次执行 java -version 和 javac -version
二者应该来自同一个 JDK。
十一、Windows 多 JDK 环境下如何避免 javac 混乱？
如果你电脑上同时有多个 JDK：
D:\Java\jdk-8
D:\Java\jdk-11
D:\Java\jdk-17
D:\Java\jdk-21
D:\Java\jdk-25
建议只这样配置：
JAVA_HOME=D:\Java\jdk-17
Path=%JAVA_HOME%\bin
不要在 Path 里同时放：
D:\Java\jdk-8\bin
D:\Java\jdk-11\bin
D:\Java\jdk-17\bin
D:\Java\jdk-21\bin
这会让版本切换变得很难排查。
切换 JDK 时，只改：
JAVA_HOME
例如切换到 JDK21：
JAVA_HOME=D:\Java\jdk-21
然后重新打开命令行，验证：
java -version
javac -version
where java
where javac
十二、临时切换 javac 版本
有时候你只是想临时测试某个 JDK，不想改系统环境变量。
CMD 临时切换到 JDK21：
set JAVA_HOME=D:\Java\jdk-21
set PATH=%JAVA_HOME%\bin;%PATH%
java -version
javac -version
PowerShell 临时切换：
$env:JAVA_HOME="D:\Java\jdk-21"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
java -version
javac -version
注意：这种方式只对当前窗口有效，关闭窗口后失效。
适合临时测试：
某个项目能否用 JDK21 编译
某个 Maven 构建是否依赖特定 JDK
某个 Gradle 项目是否兼容新 JDK
十三、IDEA 里 javac 报错怎么办？
有时候命令行里 javac -version 正常，但 IDEA 里仍然报编译错误。
常见错误：
Cannot start compilation: no JDK configured
java: invalid source release: 17
No compiler is provided in this environment
Project SDK is not defined
这说明 IDEA 没有使用你命令行中的 JDK。
检查这些位置：
File > Project Structure > Project > Project SDK
File > Project Structure > Modules > Dependencies > Module SDK
Settings > Build Tools > Maven > Runner > JRE
Settings > Build Tools > Gradle > Gradle JVM
Run > Edit Configurations > JRE
建议统一成项目要求的 JDK。
例如项目使用 JDK17：
Project SDK = JDK17
Module SDK = Project SDK
Maven Runner JRE = JDK17
Gradle JVM = JDK17
Run Configuration JRE = Project SDK
详细教程可以看：
十四、Maven 报 No compiler is provided 怎么办？
Maven 项目中经常遇到：
No compiler is provided in this environment. Perhaps you are running on a JRE rather than a JDK?
这个错误和 javac 找不到高度相关。
意思是：
Maven 当前运行环境没有找到 Java 编译器
常见原因：
1. Maven 使用的是 JRE
2. JAVA_HOME 指向错误
3. IDEA Maven Runner JRE 选错
4. 系统 Path 中 Java 路径混乱
先执行：
mvn -version
重点看：
Java version
Java home
如果项目需要 JDK17，但这里显示 JRE 或 JDK8，就要修正。
Maven Runner JRE 检查路径：
Settings > Build Tools > Maven > Runner > JRE
建议选择：
Project JDK
或者指定：
JDK17
JDK21
Maven 依赖下载失败可以看：
Maven Could not transfer artifact 下载失败解决：settings.xml、国内镜像、本地缓存与代理排查
十五、Maven 编译版本也要检查
即使 javac 正常，Maven 编译版本也可能不对。
如果项目是 JDK17，建议在 pom.xml 中写：
<properties>
<maven.compiler.release>17</maven.compiler.release>
</properties>
如果项目是 JDK21：
<properties>
<maven.compiler.release>21</maven.compiler.release>
</properties>
如果项目是 JDK8：
<properties>
<maven.compiler.release>8</maven.compiler.release>
</properties>
老项目也常见：
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
但 JDK9 以后更建议使用：
<maven.compiler.release>
如果你遇到：
invalid source release: 17
通常是：
当前 Maven 使用的 JDK 版本低于 17
比如你用 JDK8 去编译 release 17，就会失败。
十六、Gradle 中 javac 不生效怎么办？
Gradle 项目中，如果 JDK 配置错误，也可能出现编译器相关问题。
先执行：
gradlew.bat --version
或者：
./gradlew --version
重点看：
JVM
如果 JVM 版本不对，检查：
JAVA_HOME
Path
IDEA Gradle JVM
Java Toolchain
Gradle 项目建议使用 Java Toolchain。
JDK17：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
JDK21：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(21)
}
}
Gradle 下载慢可以看：
Gradle国内镜像配置教程：init.gradle、repositories与Wrapper加速完整指南
十七、用一个 HelloWorld 测试 javac 是否正常
你可以新建一个文件：
HelloWorld.java
内容：
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, Java!");
}
}
在当前目录执行：
javac HelloWorld.java
如果成功，会生成：
HelloWorld.class
然后执行：
java HelloWorld
正常输出：
Hello, Java!
如果 javac HelloWorld.java 失败，说明编译器配置仍然有问题。
如果 javac 成功但 java HelloWorld 失败，可能是当前目录、包名、classpath 或 Java 版本问题。
十八、有 package 的 Java 文件怎么编译？
如果你的 Java 文件里有包名：
package com.example;
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, Java!");
}
}
文件路径应该是：
com\example\HelloWorld.java
编译：
javac com\example\HelloWorld.java
运行：
java com.example.HelloWorld
注意不要写：
java com\example\HelloWorld
也不要写：
java HelloWorld
因为带 package 的类要使用完整类名运行。
这类问题和 javac 是否安装成功不是一回事，不要混在一起判断。
十九、完整排查清单
遇到 javac 不是内部或外部命令，按下面顺序检查：
1. 确认安装的是 JDK，不是 JRE
2. 确认 JDK 目录下有 bin\javac.exe
3. 执行 java -version
4. 执行 javac -version
5. 执行 echo %JAVA_HOME%
6. 执行 where java
7. 执行 where javac
8. 确认 JAVA_HOME 指向 JDK 根目录
9. 确认 Path 包含 %JAVA_HOME%\bin
10. 确认 Path 中旧 Java 路径没有排在前面
11. 删除或下移 Oracle javapath
12. 关闭并重新打开命令行
13. 检查 IDEA Project SDK
14. 检查 Maven Runner JRE
15. 检查 Gradle JVM
16. 用 HelloWorld.java 测试编译和运行
PowerShell 命令：
java -version
javac -version
echo $env:JAVA_HOME
where.exe java
where.exe javac
二十、推荐最终配置
假设你使用 JDK17：
JDK目录：
D:\Java\jdk-17
JAVA_HOME：
D:\Java\jdk-17
Path：
%JAVA_HOME%\bin
验证命令：
echo %JAVA_HOME%
where java
where javac
java -version
javac -version
理想输出路径：
D:\Java\jdk-17\bin\java.exe
D:\Java\jdk-17\bin\javac.exe
如果使用 JDK21：
JAVA_HOME=D:\Java\jdk-21
Path=%JAVA_HOME%\bin
切换版本时只改 JAVA_HOME，不要反复改 Path。
二十一、常见问题 FAQ
1. javac 是什么？
javac 是 Java 编译器，用来把 .java 文件编译成 .class 文件。
例如：
javac HelloWorld.java
2. 为什么 java 能用，javac 不能用？
常见原因是当前环境能找到 java.exe，但找不到 javac.exe。
这通常说明：
1. 只安装了 JRE
2. Path 没有指向 JDK 的 bin 目录
3. JAVA_HOME 配置错了
4. java 和 javac 来自不同目录
3. JRE 里有 javac 吗？
通常没有。
开发 Java 项目请安装 JDK。
4. JAVA_HOME 要写到 bin 吗？
不要。
正确：
JAVA_HOME=D:\Java\jdk-17
Path 中添加：
%JAVA_HOME%\bin
5. where javac 找不到怎么办？
说明当前 Path 中没有可用的 javac.exe。
检查：
1. JDK 是否安装完整
2. JAVA_HOME 是否正确
3. Path 是否包含 %JAVA_HOME%\bin
4. 命令行是否重新打开
6. java 和 javac 版本不一致怎么办？
执行：
where java
where javac
看它们分别来自哪个目录。
然后调整 Path，确保二者都来自同一个 JDK。
7. IDEA 里报 javac 相关错误怎么办？
检查：
Project SDK
Module SDK
Maven Runner JRE
Gradle JVM
Run Configuration JRE
命令行配置正确，不代表 IDEA 一定使用同一个 JDK。
8. Maven 报 No compiler is provided 和 javac 有关系吗？
有关系。
这个错误通常表示 Maven 当前运行环境没有可用的 Java 编译器，常见原因是 Maven 使用了 JRE 或错误 JDK。
执行：
mvn -version
看 Java home 是否正确。
9. 需要配置 CLASSPATH 吗？
普通现代 Java 开发一般不需要手动配置全局 CLASSPATH。
新手只需要先配置好：
JAVA_HOME
Path
Maven / Gradle 项目会自己管理依赖和 classpath。
10. 改完环境变量必须重启电脑吗？
通常不用。
先关闭并重新打开命令行即可。
如果还是不生效，再重启 IDEA、Windows Terminal，最后才考虑重启电脑。
二十二、最终总结
javac 不是内部或外部命令 的核心原因通常是：
系统没有找到 JDK 的 bin 目录
记住这几个规则：
开发 Java 要安装 JDK，不是 JRE
JAVA_HOME 指向 JDK 根目录
Path 添加 %JAVA_HOME%\bin
不要把 JAVA_HOME 指到 bin
不要在 Path 里堆多个 JDK
用 where javac 查看真实路径
修改环境变量后重新打开命令行
IDEA / Maven / Gradle 也要单独检查 JDK
推荐最终配置：
JAVA_HOME=D:\Java\jdk-17
Path=%JAVA_HOME%\bin
验证：
java -version
javac -version
where java
where javac
如果 java.exe 和 javac.exe 都来自同一个 JDK 目录，问题基本就解决了。
二十三、相关文章
Windows 安装 JDK 可以看：
Windows安装JDK 8 / 17 / 21 / 25完整教程：JAVA_HOME环境变量配置与验证
如果配置 JAVA_HOME 后仍然显示旧版本，可以看：
Windows配置JAVA_HOME后不生效怎么办？java -version显示旧版本解决办法
JDK 下载地址可以看：
各版本JDK镜像下载地址：JDK8 / JDK11 / JDK17 / JDK21 / JDK25 / JDK26 下载与IDEA配置指南
IDEA 配置 JDK 可以看：
Maven 下载依赖失败可以看：
Maven Could not transfer artifact 下载失败解决：settings.xml、国内镜像、本地缓存与代理排查
完整 Java 环境配置可以看：
Java开发环境配置专题：JDK、IDEA、Maven、Gradle、版本兼容与常见报错
更新记录
2026-06-11：
- 创建 javac 不是内部或外部命令完整排查教程
- 增加 java / javac / where 命令检查方法
- 增加 JAVA_HOME 和 Path 配置说明
- 增加 java 正常但 javac 不正常的原因分析
- 增加 java 和 javac 版本不一致排查
- 增加 IDEA / Maven / Gradle 中 javac 相关问题排查
- 增加 HelloWorld.java 编译测试示例
javac不是内部或外部命令怎么解决？JDK、JAVA_HOME和Path完整排查
https://java.li/archives/javac-not-recognized-windows-java-home-path
评论