IntelliJ IDEA 通过 JPS 编译服务器实现了对 Maven 项目的增量注解处理（APT），其核心依赖于 jps.track.ap.dependencies 系统属性与自定义 JavaFileManager，可追踪生成文件的源元素依赖关系，从而在源码变更后精准触发重处理。
intellij idea 通过 jps 编译服务器实现了对 maven 项目的增量注解处理（apt），其核心依赖于 `jps.track.ap.dependencies` 系统属性与自定义 `javafilemanager`，可追踪生成文件的源元素依赖关系，从而在源码变更后精准触发重处理。
IntelliJ IDEA 对 Maven 项目的增量注解处理（Incremental Annotation Processing, IAP）并非直接复用 Maven 插件生态（如 maven-compiler-plugin 的 -proc:only 或 annotationProcessorPaths），而是深度集成于其专有的 JPS（JetBrains Project System）编译服务器中。该机制独立于 Maven 构建生命周期，专为 IDE 内实时编译（Make / Build Project）优化设计。
其工作原理可概括为三步：
启用开关控制：
增量 APT 行为由 JVM 系统属性jps.track.ap.dependencies=true控制（默认为false）。需在 IntelliJ 的 Help → Edit Custom VM Options… 中添加该行，并重启 IDE 生效。此属性直接影响JavacMain.java中TRACK_AP_GENERATED_DEPENDENCIES的布尔值，进而决定是否注入依赖追踪上下文。依赖关系捕获：
当启用后，IDEA 会包装javax.tools.JavaCompiler.CompilationTask，并使用自定义ProcessingContext和DiagnosticOutputConsumer包装器（见APIWrappers类）。关键在于——它通过重写JavaFileManager.getFileForOutput()方法（具体实现在JpsJavacFileManager.java#L665），在注解处理器生成.java或.class文件时，自动记录每个生成文件所依赖的“源元素”（originating elements），例如被@Entity标记的类、被@BindView引用的字段等。增量决策执行：
下次编译变更后的源文件时，JPS 编译器会查询该依赖图谱：若某修改类是此前某生成文件的 originating element，则关联的注解处理器将被重新调用；反之，若仅修改了非源头的普通类，则跳过相关 APT 阶段。这与 Gradle 6.6+ 的增量 APT 设计理念一致，但实现路径完全独立。
✅ 实际效果示例：
假设你使用 Lombok 或 MapStruct：
// User.java —— 修改此处
@Data
public class User { private String name; }
→ IDEA 仅重新运行 Lombok 处理器生成 User 的 getter/setter，而不会重复处理未改动的 Order.java 及其生成的 OrderMapperImpl.java。
使用3×3×10框架生成90+个个性化Instagram内容创意，用AI编辑器精选最佳创意，并将获胜者扩展为可操作的简洁内容。
⚠️ 重要限制与注意事项：
- ❌ 不适用于
mvn compile命令行构建（Maven 本身不支持标准增量 APT，需依赖compile-mojo的实验性配置或第三方插件如net.orfjackal.retrolambda:retrolambda-maven-plugin）； - ❌ 若注解处理器未正确声明
@SupportedOptions或使用反射绕过ProcessingEnvironment，依赖追踪可能失效； - ⚠️ 启用
jps.track.ap.dependencies后，首次全量编译可能略慢（因构建依赖图谱），但后续编辑-编译循环显著提速； - ? 验证是否生效：开启 Build → Compilation → Compiler logs，观察日志中是否出现
Tracked AP output for …或Skipping processor … (no originating elements changed)类提示。
综上，IntelliJ IDEA 的增量 APT 是一项成熟、隐蔽但高度工程化的 IDE 内建能力。它不依赖外部文档，而藏身于开源代码中——开发者可通过阅读 intellij-community/jps/ 模块源码深入理解其实现细节，也可通过合理配置将其纳入日常高效开发流。
