javac提示“不是内部或外部命令”是因java_home未配置或path未包含%java_home%\bin；public类名必须与文件名严格一致；运行“找不到主类”多因包路径、类路径或main签名错误；版本不匹配需用-source/-target或--release指定兼容性。
javac 命令提示“不是内部或外部命令”
说明系统根本没识别到 javac，不是代码问题，而是环境变量配置失效。常见于安装 JDK 后未正确设置 JAVA_HOME 或未把 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）加入 PATH。
- 检查
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux）是否输出 JDK 安装路径，如C:\Program Files\Java\jdk-17.0.1 - 确认
PATH中包含%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux），注意路径中不能有空格未加引号（Windows 下尤其容易出错） - 重启终端或命令行窗口——环境变量修改后不会自动生效到已打开的 shell
- 运行
where javac（Windows）或which javac（macOS/Linux）验证是否能定位到可执行文件
编译时报错 “error: class XXX is public, should be declared in a file named XXX.java”
这是 Java 源文件命名规则强制要求：如果类声明为 public，文件名必须与类名完全一致（包括大小写），且扩展名为 .java。Windows 下不区分大小写可能“侥幸通过”，但 Linux/macOS 会直接报错。
- 检查文件名是否和
public class名称严格一致，例如public class HelloWorld必须保存为HelloWorld.java，而非helloworld.java或HelloWorld.JAVA - 避免在 IDE 中新建文件后手动改名却不同步修改类声明——有些编辑器不会自动更新类名
- 若项目含多个类，确保只有一个是
public，且只有一个同名文件；其余非 public 类可放在同一文件中（不推荐），或单独文件但不加public修饰
javac 编译成功但运行时报 “Error: Could not find or load main class XXX”
编译通过只代表语法没问题，运行失败通常源于类路径（-cp 或 -classpath）或包声明（package）不匹配。
- 如果源码含
package com.example;，则.java文件必须放在com/example/子目录下，且需从该目录的父级执行javac com/example/HelloWorld.java和java com.example.HelloWorld - 运行时若不在当前目录，必须显式指定类路径，例如
java -cp . com.example.HelloWorld；遗漏-cp .是 Windows 用户最常踩的坑 - 检查
main方法签名是否完整：public static void main(String[] args)—— 少一个static、参数类型写成string[]（小写 s）或String args（缺[]）都会导致找不到入口
使用不同 JDK 版本编译却在旧 JRE 上运行失败
Java 编译器默认按当前 JDK 版本生成字节码，而旧版 JRE 无法加载高版本字节码，会报类似 UnsupportedClassVersionError: xxx has been compiled by a more recent version of the Java Runtime 的错误。
立即学习“Java免费学习笔记（深入）”；
- 用
javac -version和java -version分别确认编译器与运行时版本，二者主版本号应一致或运行时 ≥ 编译器 - 若需兼容低版本 JRE，可用
javac -source 8 -target 8 HelloWorld.java显式指定源码语法版本和生成字节码版本（JDK 9+ 推荐用--release 8替代，它还会限制 API 使用范围） - IDE（如 IntelliJ、Eclipse）中需同步配置 Project SDK、Project language level、Target bytecode version，三者不一致极易引发此类问题
javac --release 11 HelloWorld.java java HelloWorld真正卡住人的往往不是语法，而是
JAVA_HOME 拼错一个斜杠、package 目录结构少建一层、或者以为 java HelloWorld 能运行带包名的类——这些细节在命令行里没有容错，也不会给你任何提示，只甩一句“找不到类”。 
