processingenvironment 是注解处理器全局唯一上下文，在 init() 中由编译器注入，提供 elements、types、filer、messager 等工具；roundenvironment 代表单次处理轮次上下文，在 process() 中传入，用于获取本轮被注解的元素。
在 Java 注解处理器（APT）中，ProcessingEnvironment 是注解处理器的“上下文环境”，由编译器注入，用于获取工具类、日志、元素处理等能力；而 RoundEnvironment 则代表当前注解处理轮次的上下文，用于获取本轮中被标注的元素。二者不能直接 new，必须通过标准生命周期方法获得。
ProcessingEnvironment 在 init() 中获取
ProcessingEnvironment 由编译器在调用处理器的 init() 方法时传入，是整个处理器生命周期中唯一且稳定的入口点。它提供关键工具：
-
getElementUtils()：获取Elements工具，用于操作类型、包、方法等元素 -
getTypeUtils()：获取Types工具，用于类型比较、泛型解析等 -
Filer：用于生成源文件、class 文件或资源文件 -
Messager：用于输出编译期提示、警告或错误信息
示例：
@Override
public void init(ProcessingEnvironment processingEnv) {
super.init(processingEnv);
this.elementUtils = processingEnv.getElementUtils();
this.typeUtils = processingEnv.getTypeUtils();
this.filer = processingEnv.getFiler();
this.messager = processingEnv.getMessager();
}
RoundEnvironment 在 process() 中获取
RoundEnvironment 每次调用 process() 方法时都会传入，代表当前注解处理轮次的状态。它只在本轮有效，不可缓存复用。主要用途是：
-
getRootElements()：获取本轮所有被编译器解析出的顶层元素（如类、接口） -
getElementsAnnotatedWith(Class extends Annotation>)：获取被指定注解标记的元素（最常用） -
processingOver()：判断是否为最后一轮（可用于清理或收尾逻辑）
注意：即使没有匹配的注解，process() 仍会被调用至少一次（初始轮），此时 getElementsAnnotatedWith(...) 返回空集合。
示例：
@Override
public boolean process(Set extends TypeElement> annotations, RoundEnvironment roundEnv) {
for (TypeElement annotation : annotations) {
Set extends Element> annotatedElements =
roundEnv.getElementsAnnotatedWith(annotation);
for (Element element : annotatedElements) {
// 处理被 @MyAnnotation 标记的类、字段或方法
if (element instanceof TypeElement) {
// 解析类
}
}
}
return true; // 声明已处理，避免其他处理器重复处理该注解
}
二者关系与使用时机
ProcessingEnvironment 是全局、单例、线程安全的（编译器保证），适合初始化工具和缓存引用；RoundEnvironment 是每轮新建、仅当轮次有效，必须在 process() 内使用，不能跨轮保存或传递。
- 不要在
process()外保存RoundEnvironment引用 - 不要在
init()中尝试访问元素或注解——此时 AST 尚未完全构建 - 若需跨轮累积数据（如收集所有被注解类），应使用成员变量 + 轮次判断（
!roundEnv.processingOver()）
常见误区提醒
容易混淆的是：ProcessingEnvironment.getElementUtils().getTypeElement("xxx") 可能返回 null，因为该方法只查已加载的类型（如已编译或已处理的类），不支持未编译的引用；而 RoundEnvironment 中的 getElementsAnnotatedWith() 才是获取当前编译单元中实际存在的被注解元素的正确方式。
另外，TypeElement 是 Element 的子类，代表类/接口；获取其字段或方法需用 getEnclosedElements()，再按 ElementKind 过滤，而非直接强转。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
