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 流水线、需要发布到中央仓库的库项目。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
-
pom.xml中的<packaging>jar</packaging>决定了最终产物类型，影响插件绑定（如maven-jar-plugin是否激活） - 依赖范围（
<scope>test</scope>）直接影响编译类路径 ——test范围的依赖不会参与主代码编译 - 默认编译目标 Java 版本由
maven-compiler-plugin的<source></source>和<target></target>控制，不是 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<javacompile></javacompile>比 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里配<annotationprocessorpaths></annotationprocessorpaths>，否则即使provided依赖了处理器，也不会触发 - Gradle 中需通过
annotationProcessor配置项引入，而不是implementation—— 后者不会被编译器发现
javac、传了哪些参数、类路径从哪来、以及注解处理器在哪个阶段介入。这些细节一旦错位，就会出现“本地好好的，打包就报错”这类问题。 
