应按需选择@Retention策略:SOURCE仅编译期有效,CLASS供构建期工具使用,RUNTIME仅在运行时反射必需时启用,避免性能与安全开销。

选对 @Retention 策略,本质是权衡“要不要在运行时看到它”。不是越强越好,而是按需最小化——该丢的早丢,该留的才留。
RUNTIME:只在真需要反射读取时启用
这类注解会进入 JVM 方法区,参与类加载、常量池解析,并支持 getAnnotation() 调用。但代价明确:
- 每个带 RUNTIME 注解的类/方法/字段,都会增加字节码体积和元空间压力
- 反射访问比普通字段慢 10–100 倍,高频调用必须缓存结果
- 调试信息可能意外暴露(如日志开关、权限标记)
适用场景:
- 框架动态行为控制:Spring 的
@Component、@Transactional - 运行时条件判断:如
@LogExecution(enabled = true) - 序列化策略:Jackson 的
@JsonFormat、@JsonIgnore
反例:只为生成 getter/setter 或打印日志模板而设为 RUNTIME,纯属浪费。
立即学习“Java免费学习笔记(深入)”;
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
CLASS:构建期工具专用,运行时零干扰
注解写入 .class 文件,但 JVM 加载时不解析、不进内存,反射完全不可见。适合离线分析和字节码操作:
- Lombok 的
@Getter、@Builder就靠它让编译器或插件在构建阶段处理 - APT(注解处理器)生成辅助类,如 Room 的 DAO 实现
- 安全扫描、覆盖率注入、监控埋点等字节码增强场景
注意:不能用 Class.getAnnotations() 获取,得用 ASM、Byte Buddy 等库直接读 class 二进制流。
SOURCE:纯编译期服务,性能最优
只存在于 .java 源文件里,javac 编译完就清空,不占字节码、不耗内存、无任何运行时成本:
- 编译器检查:@Override、@SuppressWarnings、@NonNull(配合 Checker Framework)
- IDE 支持:触发自动补全、重构提示、空值警告
- 代码生成:Protocol Buffer 的
@Proto、自定义 APT 处理器
关键提醒:SOURCE 注解在运行时反射读取必定返回 null,别试图绕过生命周期硬用。
记住一个判断口诀:编译时要用 → SOURCE;构建时要扫 → CLASS;运行时要查 → RUNTIME。

















