Java编译工具_常用Java编译与构建工具介绍

javac是最小依赖的编译入口，仅支持单次全量编译，需手动处理源码路径、类路径和注解处理器；Maven和Gradle是构建控制器，分别通过pom.xml和DSL协调编译流程、依赖与生命周期。

javac 命令是最小依赖的编译入口，但只管单次编译

javac 是 JDK 自带的编译器，不依赖任何构建系统，适合快速验证语法或教学场景。它把 .java 文件直接编译成 .class，但不会自动处理依赖、资源文件或目录结构。

常见错误现象：javac HelloWorld.java 报错 package com.example does not exist —— 因为没指定 -sourcepath 或 -cp，也没按包路径组织源码目录。

• 源码必须严格按包名放在对应子目录中（如 com/example/HelloWorld.java）
• 引用第三方 JAR 时，必须显式加 -cp 参数：javac -cp "lib/spring-core.jar" com/example/HelloWorld.java
• 编译输出目录建议用 -d 指定，避免 class 文件散落：javac -d out src/com/example/HelloWorld.java
• 不支持增量编译，每次都是全量重编；无生命周期管理（如 test → compile → package）

Maven 的 pom.xml 定义了标准项目契约，但约定大于配置也容易卡住

Maven 不是编译器，而是基于 pom.xml 协调 javac、依赖下载、测试执行和打包流程的构建控制器。它的核心价值在于统一项目结构和依赖传递逻辑。

使用场景：团队协作、CI 流水线、需要发布到中央仓库的库项目。

• pom.xml 中的 jar 决定了最终产物类型，影响插件绑定（如 maven-jar-plugin 是否激活）
• 依赖范围（test）直接影响编译类路径 —— test 范围的依赖不会参与主代码编译
• 默认编译目标 Java 版本由 maven-compiler-plugin 的 和 控制，不是 JDK 版本本身
• 常见卡点：mvn compile 失败但 javac 成功 —— 很可能是 Maven 的 sourceDirectory 配置错位，或 resources 过滤干扰了注解处理器

Gradle 用 Groovy/Kotlin DSL 替代 XML，灵活但容易写出不可复现的 build.gradle

Gradle 的编译动作仍委托给 javac 或 ecj（Eclipse Compiler for Java），但它用脚本化方式定义任务依赖与输入输出，支持条件分支、自定义 task 和缓存策略。

性能影响：启用 compileJava.options.fork = true 可隔离 JVM 参数，但会增加 fork 开销；而 buildSrc 中的 Kotlin 构建逻辑若未正确声明依赖，会导致本地编译成功、CI 失败。

• Java 编译任务名固定为 compileJava，其 classpath 由 sourceSets.main.compileClasspath 决定，可动态追加：compileJava.classpath += files("lib/extra.jar")
• 增量编译默认开启，但若在 doFirst 中

  

  修改源码或资源，可能绕过增量检测，导致行为不一致
• Kotlin DSL（build.gradle.kts）里写 tasks.withType 比 Groovy 的 tasks.withType(JavaCompile) 类型更安全，避免反射调用失败
• 不要在 compileJava 里直接写 exec 调用外部 javac —— 这会破坏 Gradle 的构建缓存和守护进程机制

javac + annotation processor 组合能做编译期代码生成，但需注意处理器注册时机

像 Lombok、MapStruct、Dagger 这类工具，本质是在 javac 执行过程中插入自定义 AnnotationProcessor，解析注解并生成新源码或字节码。它们不改变 javac 本身，但深度耦合其编译流程。

容易踩的坑：Lombok 注解在 IDE 里生效，但命令行 javac 编译报错 —— 因为没加 -processorpath 和 -proc:only 或 -proc:full 参数。

• 必须用 -processorpath 指向处理器 JAR（如 lombok.jar），不能只放 -cp 里
• -proc:only 表示只运行处理器、不编译；-proc:full（默认）表示先处理再编译，适用于生成源码后还需编译的场景
• Maven 中需在 maven-compiler-plugin 里配 ，否则即使 provided 依赖了处理器，也不会触发
• Gradle 中需通过 annotationProcessor 配置项引入，而不是 implementation —— 后者不会被编译器发现

真正难的不是选哪个工具，而是理解每个环节谁在调用 javac、传了哪些参数、类路径从哪来、以及注解处理器在哪个阶段介入。这些细节一旦错位，就会出现“本地好好的，打包就报错”这类问题。