javac编译失败主因是路径和编码不匹配，需确认工作目录并用-javac -encoding UTF-8指定编码；运行失败多因类路径或包声明不一致；JDK需配置PATH；多文件或依赖需正确使用-cp。
javac 编译失败：找不到文件或提示“编码GBK不可映射”
常见现象是执行 javac HelloWorld.java 后报错：error: file not found: HelloWorld.java，或出现乱码、中文注释报错。本质是路径和编码不匹配。
- 确认当前终端工作目录就是
HelloWorld.java所在目录（用cd进入，别只靠眼睛看） - Windows 默认控制台用 GBK 编码，而 Java 源文件多为 UTF-8；编译时必须显式指定：
javac -encoding UTF-8 HelloWorld.java - 如果文件名含中文，确保终端也支持该编码（PowerShell 或 Git Bash 更稳妥，CMD 常翻车）
java 运行时报错“找不到或无法加载主类”
编译成功（生成了 HelloWorld.class）但运行 java HelloWorld 失败，多数情况是类路径（-cp）或包声明没对齐。
- 没有
package声明：直接在源文件所在目录运行java HelloWorld（注意：不要加.class后缀） - 有
package com.example;声明：必须在com/example/的父目录下运行，且命令为java com.example.HelloWorld - 若类在子目录中，需用
-cp显式指定根路径，例如：java -cp . com.example.HelloWorld
如何让 javac / java 命令全局可用
核心是把 JDK 的 bin 目录加进系统 PATH 环境变量，否则只能在 JDK 安装路径下用命令。
- 先确认 JDK 已安装，运行
java -version和javac -version应返回版本号；若报“不是内部或外部命令”，说明 PATH 未配置 - Windows：找到 JDK 的
bin路径（如C:\Program Files\Java\jdk-17.0.1\bin），添加到系统环境变量PATH中 -
macOS/Linux：在
~/.zshrc或~/.bash_profile中追加export PATH="/path/to/jdk/bin:$PATH"，然后执行source ~/.zshrc - 验证：新开终端，直接输入
javac -help能打印帮助即成功
编译多个文件或带依赖的简单项目
不用构建工具时，纯命令行也能处理小规模依赖，关键是按依赖顺序编译，并用 -cp 连接类路径。
立即学习“Java免费学习笔记（深入）”；
- 两个类互相引用（
A.java用到了B.class）：一起编译更安全 ——javac A.java B.java - 引用了外部 JAR（如
gson-2.10.1.jar）：编译时用-cp包含它：javac -cp ".;gson-2.10.1.jar" Main.java（Windows 用分号，macOS/Linux 用冒号） - 运行时同样要带上 JAR：
java -cp ".;gson-2.10.1.jar" Main - 注意：
CLASSPATH环境变量容易干扰，建议始终用-cp显式控制，避免隐式行为
