javac不是内部或外部命令的根源是JAVA_HOME与PATH未协同配置：需确认JAVA_HOME指向JDK根目录、PATH包含%JAVA_HOME%\bin，修改后须重启命令行；版本不一致则用where javac查路径并清理多余JDK；macOS/Linux需正确编辑~/.zshrc或~/.bash_profile并source生效；IDE正常不等于系统环境就绪，必须终端验证编译运行。
javac 不是内部或外部命令
这是 Windows 命令行最典型的报错，意味着系统根本找不到 javac.exe。不是 Java 没装好，而是环境没配对——JAVA_HOME 和 PATH 两个变量必须协同生效。
检查步骤如下：
- 先运行
echo %JAVA_HOME%，确认输出的是 JDK 安装根目录（如C:\Program Files\Java\jdk-17.0.1），而不是 JRE 路径或空值 - 再运行
echo %PATH%，搜索里面是否包含%JAVA_HOME%\bin（注意：必须是带\bin的完整路径，只写%JAVA_HOME%不起作用） - 如果手动添加过 PATH，请确认没有多余空格、中文字符或反斜杠方向错误（应为
\，不是/） - 修改完环境变量后，必须关闭并重新打开命令行窗口，旧窗口不会自动刷新 PATH
javac 版本和 java 版本不一致
运行 java -version 和 javac -version 输出版本号不同，说明系统 PATH 中混入了多个 JDK。常见于曾安装过 OpenJDK、Adoptium、Zulu 或旧版 Oracle JDK，卸载不干净导致残留 bin 目录仍在 PATH 里。
排查方法：
立即学习“Java免费学习笔记（深入）”；
- 执行
where javac（Windows）或which javac（macOS/Linux），看返回几个路径 - 逐个检查这些路径下的
javac.exe所属 JDK 版本：进入对应目录，运行.\bin\javac -version - 优先保留你主动安装的 JDK（比如刚下载的 jdk-21），删掉 PATH 中其他 JDK 的
bin条目 - 不要依赖 “系统自带 Java” —— Windows 自带的 Java Runtime 不含
javac，仅含java
Mac 或 Linux 上 bash/zsh 配置未生效
在 macOS 或 Linux 终端中，即使正确设置了 JAVA_HOME 和 PATH，仍提示 command not found: javac，大概率是 shell 配置文件没加载或写错位置。
关键点：
- macOS Catalina 及以后默认用
zsh，应编辑~/.zshrc；若还用bash，则改~/.bash_profile（不是~/.bashrc，后者在登录 shell 中通常不被读取） -
JAVA_HOME必须用export JAVA_HOME=$(/usr/libexec/java_home -v 17)这类动态方式，或明确指定路径如export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home -
PATH添加必须写成export PATH=$JAVA_HOME/bin:$PATH，顺序不能颠倒（否则可能调用到系统自带低版本） - 改完后执行
source ~/.zshrc（或对应文件），再新开终端验证
IDE 显示正常但命令行失败
IntelliJ 或 VS Code 能编译 Java 文件，但终端里 javac 报错，说明 IDE 内置了 JDK 并自行配置了构建路径，和系统环境无关。这不是“修复成功”，只是掩盖了问题。
这种情况下务必坚持在终端验证：
- 新建一个最简
Hello.java：public class Hello { public static void main(String[] args) { System.out.println("OK"); } } - 用
javac Hello.java编译，再用java Hello运行 —— 这才是真实环境可用性的底线测试 - 很多 CI/CD 流程、脚本、Docker 构建都依赖命令行
javac，IDE 正常 ≠ 环境就绪 - 特别注意 Windows 用户：PowerShell 和 CMD 的环境变量是分开继承的，CMD 里设好了，PowerShell 里还得重设
真正卡住人的往往不是 JDK 下载或安装，而是 PATH 中多了一个空格、少了一个 \bin、或者 shell 配置文件选错了。环境变量这东西，差一个字符就不工作，没法“差不多”。
