javac编译失败主因是JDK未安装或PATH未配置，需检查javac -version或which javac；文件名须与public类名一致，中文需指定-encoding UTF-8；包声明决定目录结构，-cp指定依赖路径，-d控制输出目录；java运行时需用全限定类名且-cp匹配.class位置。
javac 命令编译失败：常见报错和路径问题
直接运行 javac HelloWorld.java 报 “command not found” 或 “无法找到或加载主类”，大概率是 JDK 没装，或者 PATH 没配对。Windows 下检查 javac -version 是否输出版本号；macOS/Linux 用 which javac 看是否在 /usr/bin/javac（通常是符号链接）或 $JAVA_HOME/bin/javac。
如果已安装但提示找不到命令，手动把 $JAVA_HOME/bin 加进 PATH（bash/zsh 的 ~/.zshrc 或 ~/.bash_profile 中追加 export PATH=$JAVA_HOME/bin:$PATH），然后执行 source ~/.zshrc 生效。
-
javac只认.java后缀文件，且文件名必须和public class名完全一致（大小写敏感） - 源文件里有中文字符？确保用
-encoding UTF-8显式指定，否则 Windows 默认 GBK 可能编译报错 - 包声明（
package com.example;）不是可选装饰——它决定了目录结构。类在com/example/HelloWorld.java，就必须在com/example/目录下执行javac HelloWorld.java，或从项目根目录用javac com/example/HelloWorld.java
javac 编译多个文件或依赖外部 JAR
单个文件简单，但涉及多个类或第三方库时，javac 的 -cp（classpath）参数不能省。它告诉编译器去哪里找被 import 的类，包括你自己的其他 .class 或 .jar。
比如当前目录有 A.java 和 B.java，且 A 用了 B，直接 javac A.java B.java 就行；但如果 A 还 import 了 org.json.JSONObject，就得带上 JSON 库：
立即学习“Java免费学习笔记（深入）”；
javac -cp "lib/json.jar" A.java B.java
注意：-cp 值里用冒号（:）分隔多个路径（macOS/Linux），Windows 用分号（;）；路径支持通配符，如 -cp "lib/*"（JDK 6+ 支持，但不递归子目录）。
- 编译生成的
.class默认放在和源文件同一目录；用-d out可指定输出目录，此时会按包名自动建子目录（例如package com.example;→out/com/example/） -
-d和-cp是独立的：前者控制输出位置，后者控制输入依赖，别混淆 - 如果用了
-d out，后续java运行时也得用-cp out，否则找不到类
java 命令运行时报 NoClassDefFoundError 或 Could not find or load main class
这两个错误看着像，根源不同：NoClassDefFoundError 是运行时发现类存在但初始化失败（比如静态块抛异常）；而 Could not find or load main class 是根本没定位到含 public static void main(String[]) 的类——90% 是 classpath 或类名写错了。
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
关键点：运行 java 时，传给它的不是文件名，是「类的全限定名」（fully qualified name），不含 .class 后缀，且必须匹配包声明。
例如 com/example/HelloWorld.java 编译后生成 com/example/HelloWorld.class，运行命令必须是：
java -cp . com.example.HelloWorld
注意：-cp . 表示从当前目录开始搜，而 com.example.HelloWorld 中的点（.）对应目录分隔符（/ 或 \）。
- Windows 下路径分隔符是反斜杠，但类名里的点永远用英文点，不要写成
com\example\HelloWorld - 如果类在默认包（即没有
package声明），就直接用类名，如java HelloWorld，但此时不能在子目录里运行，否则类路径不对 -
java不会自动搜索子目录，-cp lib/*只展开 jar，不包含lib/sub/xxx.jar—— 得手动列全
Java 11+ 开始支持直接运行源文件（无需先 javac）
JDK 11 引入了 java 命令直接执行 .java 文件的能力，适合快速验证小脚本，但仅限单文件、无复杂依赖的场景。
例如：
java HelloWorld.java
这会隐式完成编译 + 运行两步，临时 class 文件存在内存中，不落地。但它不支持 package 声明——只要源文件顶部有 package xxx;，就会报错。
- 支持传参：
java HelloWorld.java arg1 arg2，这些参数会作为main方法的args数组 - 支持
-cp：java -cp "lib/json.jar" HelloWorld.java，可用于带简单依赖的脚本 - 不推荐用于正式开发：无法复用编译结果、调试信息弱、IDE 不识别这种模式、多人协作易混乱
真正容易被忽略的是包路径与 classpath 的耦合关系——哪怕一个字母大小写错，或少一个目录层级，java 就会静默失败。动手前先用 find . -name "*.class"（Linux/macOS）或 dir /s *.class（Windows）确认类文件实际在哪，再反推该用什么 -cp 和什么类名。
