Java编译需依项目类型选择合适方式：单文件用javac按包结构组织并注意-classpath；Maven项目需配置pom.xml及annotationProcessorPaths；模块化项目须用--module-path并先编译module-info.java；IDE编译易掩盖问题，稳定构建应依赖构建工具而非手动命令。
Java 编译不是只有 javac 一种用法，不同项目结构、依赖管理、构建目标下，编译行为差异很大，直接用命令行硬敲容易漏掉类路径、注解处理器或模块信息。
单文件编译：javac 最简用法与常见报错
适用于无依赖、无包声明的练习代码。但一旦出现 package 声明或引用其他类，就立刻失败。
- 正确姿势：进入源文件所在目录，按包结构组织子目录，例如
com/example/Hello.java，然后执行javac com/example/Hello.java - 典型错误：
error: cannot find symbol—— 多因未加-cp指定依赖 JAR 或当前目录（-cp .） - 注意：
javac默认不递归编译依赖的.java文件，需显式列出或配合-sourcepath
Maven 项目中触发编译：不只是 mvn compile
Maven 的编译受 pom.xml 中多个配置影响，不是调用一次命令就完事。
-
mvn compile只编译src/main/java，跳过测试代码；想连测试一起编译用mvn test-compile - 若用 Lombok 或 MapStruct，必须确认
annotationProcessorPaths已在maven-compiler-plugin中声明，否则生成代码不会出现 - JDK 版本不一致时（如
source是 17，但release设为 11），编译可能通过但运行时报UnsupportedClassVersionError
模块化项目（Java 9+）编译：绕不开 --module-path 和 --add-modules
传统 -cp 在模块路径（--module-path）下失效，且模块声明（module-info.java）必须最先编译。
- 顺序关键：先编译
module-info.java，再编译其余源文件，否则报module not found - 依赖模块必须显式提供路径：
javac --module-path mods -d out src/**/*.java，其中mods是已编译模块 JA
R 或目录
-
--add-modules java.xml.bind这类参数只影响运行时模块图，对编译无用；编译期需靠--module-path+ 模块声明中的requires
IDE 中“编译”按钮实际做了什么？
IntelliJ/Eclipse 不是简单调 javac，而是维护独立的编译上下文，容易掩盖真实构建问题。
- IDE 可能跳过
module-info.java校验，或自动补全-cp，导致本地能跑、CI 上编译失败 - 启用 “Build project automatically” 时，部分注解处理器（如 Dagger）可能未被触发，需手动执行
Build → Rebuild Project - 导出可运行 JAR 时，IDE 默认打包方式（如 “extract and merge”）和 Maven Shade 插件行为不同，类加载冲突风险更高
真正稳定的编译流程，得从构建工具定义出发，而不是依赖 IDE 点一下或者手敲一条 javac 命令——尤其当项目含注解处理、多模块、跨 JDK 版本时，编译器参数的微小遗漏就会让整个构建链路卡在最开始。
