apt是java编译期注解处理机制，核心作用是在编译阶段扫描注解、读取元素信息并生成新java源文件而不修改原代码。
什么是APT与注解处理器的核心作用
APT（Annotation Processing Tool）是Java 5引入、在Java 8中被集成进javac的编译期注解处理机制。它允许你在源码编译阶段扫描特定注解，读取元素信息，并自动生成新的Java源文件（如.java），而**不修改原有代码**。这正是诸如Lombok、ButterKnife（旧版）、Room、MapStruct等框架实现“零运行时反射”的基础。
编写一个最简注解处理器的三步关键操作
要让编译器在javac阶段调用你的处理器，需同时满足：声明注解、实现Processor、注册处理器。缺一不可。
-
定义一个可被编译期处理的注解：必须用
@Retention(RetentionPolicy.SOURCE)，且通常搭配@Target（如ElementType.TYPE或ElementType.FIELD） -
继承
AbstractProcessor并重写核心方法：-
getSupportedAnnotationTypes()：返回你关心的注解全限定名（如"com.example.BindView"），推荐用Set.of()或Collections.singleton() -
process()：真正干活的地方——遍历RoundEnvironment中的被注解元素，用Filer生成源码，用Messager输出日志或错误
-
-
通过
META-INF/services/javax.annotation.processing.Processor注册：文件内容只有一行，写上你的处理器类全名（如com.example.BindViewProcessor）
用Filer生成源码的实用要点
生成源码不是拼字符串，而是借助Filer和JavaFileObject安全创建合法Java文件。常见误区是忽略包名、类名冲突或编码问题。
- 调用
filer.createSourceFile("com.example.UserViewBinding")获取JavaFileObject，再用openWriter()写入内容 - 务必手动写入
package com.example;和import语句，否则生成的类无法编译 - 生成类名建议基于原类+后缀（如
UserActivity$$ViewBinder），避免硬编码冲突；可用element.getSimpleName().toString()+"$$Binding" - 若需复杂代码结构（如方法体、注解、泛型），推荐搭配
JavaPoet库——它专为安全生成Java源码设计，自动处理缩进、分号、导入、重复类名检测等
在项目中启用并调试注解处理器
现代构建工具已屏蔽原始APT命令，但原理一致。关键在于让处理器参与编译流程，并能及时看到错误提示。
-
Maven：把处理器模块作为
provided依赖引入主模块；或使用maven-compiler-plugin配置<annotationprocessors></annotationprocessors>显式声明 -
Gradle（Kotlin DSL）：
dependencies { compileOnly("com.example:processor:1.0") }，并确保sourceCompatibility = JavaVersion.VERSION_11及以上（高版本Java要求明确指定处理器路径） -
调试技巧：在
process()里用messager.printMessage(Diagnostic.Kind.NOTE, "Processing " + element)，配合-XprintRounds或-Xlint:processing参数查看编译器行为 - 注意：处理器不能依赖被处理模块中尚未编译完成的类（即不能用
Class.forName()），只能通过Element、TypeMirror等镜像API获取元信息
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
