javac编译失败常见原因：path未配置jdk bin目录；public类名与文件名不一致；文件名含空格/中文或编码非utf-8；存在语法错误。java运行报错多因classpath设置错误、未用全限定类名、缺失依赖jar或main方法签名不符。
javac 命令编译失败的常见原因
直接运行 javac HelloWorld.java 却提示“命令未找到”，说明 JDK 的 bin 目录没加进系统 PATH。Windows 下检查环境变量是否包含类似 C:\Program Files\Java\jdk-17\bin 的路径；macOS/Linux 则确认 ~/.zshrc 或 ~/.bash_profile 中有 export PATH=$JAVA_HOME/bin:$PATH，且 JAVA_HOME 指向正确 JDK 根目录。
编译报错 error: class HelloWorld is public, should be declared in a file named HelloWorld.java，是因为 public 类名必须与文件名完全一致（包括大小写），且一个 .java 文件最多只能有一个 public 类。
- 文件名含空格或中文？改用纯英文、下划线命名，例如
HelloWorld.java - 用了非 UTF-8 编码保存？在编辑器中显式设为 UTF-8，并加
-encoding UTF-8参数：javac -encoding UTF-8 HelloWorld.java - 类里有语法错误？
javac会逐行报错，优先修复第一处，再重试
java 命令运行时报 NoClassDefFoundError 或 ClassNotFoundException
这通常不是类没编译，而是类路径（classpath）没设对。运行时 java 默认只查当前目录，且**不自动包含 .class 文件所在子目录**。
假设目录结构是 src/com/example/HelloWorld.java，编译后生成 src/com/example/HelloWorld.class，那么必须从 src 目录执行：
立即学习“Java免费学习笔记（深入）”；
cd src java com.example.HelloWorld
注意：这里传给 java 的是**全限定类名**（带包名），不是文件名，也不能加 .class 后缀。
- 当前不在类根目录？用
-cp显式指定：java -cp src com.example.HelloWorld - 依赖了外部 JAR？把 JAR 路径加进
-cp，多个用:（macOS/Linux）或;（Windows）分隔：java -cp "src:lib/commons-lang3.jar" com.example.HelloWorld - 误写了
java HelloWorld.class？去掉.class，也别加扩展名
main 方法签名写错导致“找不到主方法”
运行时提示 Error: Main method not found in class ...，大概率是 main 方法声明不符合 JVM 要求。它必须同时满足：
- 访问修饰符为
public且static - 返回类型为
void - 方法名为
main - 唯一参数是
String[]类型，形参名任意，但括号位置不能错（String args[]合法，String[] args更常用）
以下写法全部无效：
static void main(String[] args) // 缺 public public void main(String[] args) // 缺 static public static int main(String[] args) // 返回值不是 void public static void main(String args) // 参数不是数组类型
Windows 和 macOS/Linux 的路径分隔符差异
javac 和 java 对路径分隔符不敏感（都支持 /），但 -cp 中多个路径拼接时，**操作系统间分隔符不同**：
- Windows 用分号：
java -cp "bin;lib/utils.jar" MyApp - macOS/Linux 用冒号：
java -cp "bin:lib/utils.jar" MyApp
写脚本时容易忽略这点。如果跨平台分发，建议用构建工具（如 Maven）管理依赖和 classpath，而不是硬编码路径。
另外，Windows 的 CMD 对引号处理较弱，含空格路径务必用双引号包裹，且避免混用单双引号；PowerShell 或 zsh 则更严格，推荐统一用双引号。
