javac编译本质是路径驱动流程：需严格匹配包结构、正确设置-classpath、指定编码及JDK版本，多数报错源于路径或环境配置错误而非语法问题。
javac 是 Java 开发的起点，不是简单“转格式”，而是依赖路径、包结构、类路径和 JDK 环境的一套严谨流程。用对了省事，错一点就报错——多数问题其实跟代码语法无关。
基础编译：单文件、无包、无依赖
适用于刚学 Java 的练习代码（比如只有一个 HelloWorld.java，没写 package）：
- 确保在 .java 文件所在目录 下执行命令，例如：
javac HelloWorld.java - 成功后生成同名
.class文件，如HelloWorld.class - 必须带
.java后缀，javac HelloWorld会报错：“Class names, 'HelloWorld', are only accepted if annotation processing is explicitly requested” - 文件名必须与 public 类名严格一致（大小写敏感），public class Demo → 文件必须叫
Demo.java
带包结构的编译：目录要匹配 package 声明
一旦源码开头有 package com.example;，就不能随便放文件或乱敲命令：
- 目录结构必须是
src/com/example/MyClass.java，不能是src/MyClass.java - 编译时要从 src 的父目录 执行：
javac -d classes src/com/example/*.java -
-d classes表示把 .class 输出到classes/目录，并自动创建classes/com/example/子路径 - 不能进到
src/com/example/目录下再运行javac *.java，否则 javac 找不到包路径，报 “cannot find symbol”
处理依赖：-cp 和 -encoding 是高频救命参数
引用外部 jar 或含中文注释时，不加参数基本会失败：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
- 编译时要用到其他 .jar（如 gson.jar）或已编译的 class，必须加
-cp（等价于-classpath）：javac -cp ".;lib/gson.jar" -d bin src/Main.java（Windows 分号；Linux/macOS 用冒号 :） - 当前目录
.要显式写进 -cp，否则 javac 默认不查当前路径下的类 - 源文件含中文（注释或字符串），CMD/终端默认用 GBK 解码，而文件是 UTF-8 编码 → 报 “编码GBK的不可映射字符”
解决：加-encoding UTF-8，例如：javac -encoding UTF-8 Main.java
环境与版本问题：javac 找不到 / 版本不匹配
这是最常卡住新手的第一关，错误提示往往是 “javac 不是内部或外部命令” 或版本对不上：
- 检查是否装了 JDK（不是 JRE）：JDK 的
bin目录下才有javac.exe（Windows）或javac（Linux/macOS） - JAVA_HOME 指向 JDK 根目录（如
C:\Program Files\Java\jdk-17），不要指向bin子目录 - PATH 中必须包含
%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（Linux/macOS） - 验证：新开终端，运行
javac -version和java -version，两个输出版本号应一致；若不一致（如 java 17、javac 1.8），说明 PATH 里混入了旧 JDK 或 JRE - 多 JDK 共存时，Windows 可手动调整 PATH 顺序；Linux/macOS 推荐用
update-alternatives --config java统一管理
不复杂但容易忽略——javac 的本质是路径驱动的工具，编译前先想清楚：文件在哪、包是什么、依赖在哪、用哪个 JDK。把这些理顺了，90% 的报错当场消失。
