Java注解本身不执行逻辑,仅是元数据;其处理方式由@Retention策略决定:SOURCE级编译时丢弃,CLASS级写入字节码但反射不可见,RUNTIME级保留至运行时供反射读取。

Java 注解本身不执行任何逻辑,它只是一段元数据。编译器是否处理它、怎么处理它,完全取决于注解的 @Retention 策略和有没有配套的处理器。
编译器对不同保留策略的处理方式
编译器不是“统一处理所有注解”,而是按生命周期分层对待:
- SOURCE 级注解(如 @Override、@SuppressWarnings):javac 在词法/语义分析阶段就读取并校验,校验通过后直接丢弃,不会写入 .class 文件。这类注解只服务编译过程,编译完就消失。
-
CLASS 级注解(默认值,未显式声明 @Retention 时):javac 会把注解信息写进字节码的
RuntimeVisibleAnnotations或RuntimeInvisibleAnnotations属性中,但类加载器加载类时不会将其注入运行时内存——所以反射调用getAnnotation()会返回 null。 -
RUNTIME 级注解:javac 同样写入字节码,且 JVM 在类加载阶段会将这些注解保留在
Class对象的内部结构中,供后续反射 API(如method.getAnnotation(MyAnno.class))安全读取。
编译期注解处理需要额外插件
仅靠 javac 默认行为,它不会主动“执行”或“响应”你定义的注解——除非你注册了注解处理器(Processor)。这是很多初学者误解的源头。
- 标准流程依赖 JSR-269 可插拔注解处理 API,需继承
AbstractProcessor并在META-INF/services/javax.annotation.processing.Processor中声明。 - 处理器在编译阶段被 javac 调用,能访问抽象语法树(AST),扫描带指定注解的元素(如类、方法),然后生成新源文件(如 Lombok 的 getter/setter)或报告错误。
- 注意:它不能修改原有源文件,但像 Lombok 这类库通过 hack 编译器内部 API 实现了 AST 改写,属于特例,非标准能力。
关键结论:编译器只做三件事
它不“理解”你的业务注解含义,只做底层支撑:
- 检查语法合法性(比如 @Target 是否匹配使用位置);
- 按 @Retention 决定是否写入字节码、写到哪一层;
- 发现已注册的 Processor 后,触发其
process()方法,并传入匹配的注解元素集合。
真正让注解“活起来”的,永远是人写的处理器或运行时框架——编译器只是个忠实的搬运工和守门人。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











