javac命令未识别是PATH配置失效的典型表现，需检查环境变量设置、终端重启及编码格式等关键环节。
javac 命令未识别：PATH 配置失效的典型表现
输入 javac -version 报错 command not found 或 'javac' is not recognized，说明系统根本找不到 javac 可执行文件。这不是 Java 安装失败，而是环境变量没生效。
- Linux/macOS：检查
~/.bashrc、~/.zshrc或/etc/profile中是否添加了export PATH=$JAVA_HOME/bin:$PATH，且执行了source ~/.zshrc（注意 shell 类型） - Windows：确认在「系统属性 → 高级 → 环境变量」中，
PATH里包含的是%JAVA_HOME%\bin，不是硬编码路径；同时确保JAVA_HOME指向 JDK 根目录（如C:\Program Files\Java\jdk-17.0.2），而非jre目录或子目录\bin - 新开终端再验证：已打开的终端不会自动继承新配置的环境变量
javac 版本与 java 版本不一致：编译器和运行时混用
运行 javac -version 和 java -version 输出版本号不同（比如 javac 是 17，java 是 11），会导致编译出的 class 文件默认使用高版本字节码，但运行时无法加载，报 UnsupportedClassVersionError。
- 优先以
JAVA_HOME为准：两个命令应指向同一 JDK 实例，不要让java来自 JRE 或另一个 JDK - 检查是否多个 JDK 共存：用
which javac（macOS/Linux）或where javac（Windows）确认实际调用路径 - IDE（如 IntelliJ）可能自带 JDK 或覆盖
JAVA_HOME，需单独检查其 Project SDK 设置
源文件名与 public 类名不匹配：Java 编译器的硬性约束
写了一个 public class Hello，却保存为 hello.java 或 HelloWorld.java，执行 javac Hello.java 会直接报错：class Hello is public, should be declared in a file named Hello.java。
- 文件名必须严格等于
public类的类名，大小写敏感（Hello.java✅，hello.java❌） - 一个
.java文件最多只能有一个public类；若无public类，则文件名可任意，但编译后生成的.class名仍按其中首个类名命名 - 包声明（
package）会影响编译路径：若含package com.example;，则该文件必须放在com/example/Hello.java目录结构下，并从父目录运行javac com/example/Hello.java
编码格式或隐藏字符导致编译失败
代码肉眼看着正常，但 javac 报出奇怪错误，例如 illegal character: '\uFFFD'、unclosed string literal 却找不到引号问题，大概率是编辑器保存了 BOM 或用了非 UTF-8 编码。
立即学习“Java免费学习笔记（深入）”；
- 用
file -i Hello.java（Linux/macOS）或xxd Hello.java | head查看实际编码；Windows 记事本默认保存为 UTF-8 with BOM，JDK 编译器不兼容 - 改用 VS Code、IntelliJ 或 Vim 等工具，显式保存为
UTF-8 without BOM - 临时验证：复制代码到
echo "public class Hello { public static void main(String[] args) { System.out.println(\"OK\"); } }" > Hello.java再编译，排除编辑器干扰
public class Hello {
public static void main(String[] args) {
System.out.println("OK");
}
}
JDK 的 javac 对路径、命名、编码都极其严格，任何一环松动都会立刻报错——它不会猜测你的意图，只认规则。最容易被忽略的是：PATH 生效与否依赖终端重启，而编码问题在纯文本编辑器里完全不可见。 
