java注解是贯穿编译、运行及框架集成的关键机制，核心在于理解其生命周期、五种元注解（@target、@retention、@documented、@inherited、@repeatable）作用及自定义与消费方式。
Java 注解不是“写完就忘”的语法糖，而是贯穿编译、运行、框架集成的关键机制。掌握它，关键在理解生命周期（源码期/编译期/运行期）、元注解作用、以及真实场景中如何自定义和消费注解。
搞懂五种元注解：它们决定注解怎么用
@Target 指定注解能加在哪——类、方法、参数、字段？不设或设错，编译直接报错。比如 @Override 只允许用在方法上，就是靠 @Target(ElementType.METHOD) 控制的。
@Retention 决定注解保留到哪一阶段：SOURCE（仅源码，javac后丢弃）、CLASS（默认，存进class文件但不加载进JVM）、RUNTIME（反射可用）。想用反射读取，必须设为 RetentionPolicy.RUNTIME。
@Documented 表示该注解会被 Javadoc 工具提取进文档；@Inherited 允许子类继承父类的注解（仅对类有效，方法/字段不继承）；@Repeatable 从 Java 8 起支持同一位置重复使用同一个注解，需配合容器注解实现。
手写一个运行时注解：从定义到反射调用
比如定义一个 @LogExecutionTime，用于标记需要记录执行耗时的方法：
// 自定义注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogExecutionTime {
String value() default "method";
}
再写个工具方法，用反射检查并执行计时逻辑：
if (method.isAnnotationPresent(LogExecutionTime.class)) {
long start = System.nanoTime();
Object result = method.invoke(obj, args);
long cost = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
System.out.println(method.getName() + " took " + cost + "ms");
return result;
}
注解不只是“标记”，更是框架的契约入口
Spring 的 @Autowired、@Controller、@Transactional，MyBatis 的 @Select、@Insert，JUnit 的 @Test、@BeforeEach —— 它们本身不干活，但框架在启动或执行时扫描这些注解，触发对应逻辑（如依赖注入、AOP代理、SQL映射、测试生命周期管理）。
真正起作用的是配套的处理器：Spring 有 BeanPostProcessor 和 AnnotationAwareBeanFactory，JUnit 5 用 Extension API，它们才是解析注解、编织行为的幕后主力。
自己开发框架或中间件时，别只定义注解，一定要配套实现对应的解析器或处理器，否则注解就是摆设。
常见坑点与避坑建议
• 注解属性只能是基本类型、String、Class、枚举、其他注解，或以上类型的数组 —— List、Map、自定义对象都不行。
• 默认值必须是编译期常量，不能是 new Object() 或方法调用结果。
• @Repeatable 注解必须声明容器注解，且容器注解的 value 属性必须是原注解类型的数组。
• 反射获取注解前，务必确认该注解的 @Retention 是 RUNTIME，否则 getAnnotation() 返回 null。
• Lombok 的 @Data、@Slf4j 等属于编译期注解，靠注解处理器（APT）在编译时生成代码，不走反射，也不出现在运行时 class 中。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
