Java注解是结构化元数据，必须用@Retention指定生命周期、@Target限定作用目标才能生效；缺一不可，否则反射读不到或编译报错。
注解（Annotation）不是“给代码加备注”的快捷方式，它本质是编译期或运行时可被读取的结构化元数据——用错时机、漏掉 @Retention 或没写 @Target，注解就等于没写。
Java 注解必须声明生命周期和作用目标才能生效
只写 @interface MyAnno 是无效的。JVM 不知道该保留到什么时候、能用在哪儿。
-
@Retention(RetentionPolicy.RUNTIME)：缺它，反射读不到；选CLASS就只能被字节码工具读，SOURCE连 class 文件都不进 -
@Target({ElementType.METHOD, ElementType.TYPE})：不加这个，编译器会拒绝你把它标在字段上 - 顺手加上
@Documented才能让 javadoc 生成时包含该注解说明
示例：
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
@Documented
public @interface ApiVersion {
String value() default "1.0";
}
运行时读取注解要用 Class/Method 对象的 getAnnotation() 方法
注解不会自动触发逻辑，必须显式调用反射 API 获取，且注意空指针风险。
-
clazz.getAnnotation(ApiVersion.class)返回null表示没标注，别直接链式调用 - 方法级注解要先拿到
Method实例：clazz.getDeclaredMethod("xxx").getAnnotation(ApiVersion.class) - 如果用了
RetentionPolicy.CLASS，getAnnotation()永远返回null——此时只能用 ASM 或 javac 插件处理
常见错误现象：NullPointerException 出现在 anno.value()，其实是前面 getAnnotation() 返回了 null。
Spring 中的注解不是“即插即用”，依赖 BeanPostProcessor 或 AOP 织入
@Autowired、@Transactional 这类注解本身不做任何事，背后是 Spring 容器在启动时扫描并注册处理器。
- 自定义注解想实现类似效果，得手动注册
BeanPostProcessor（如处理字段注入）或Aspect（如方法拦截） - 别在普通 new 出来的对象上调用
@Autowired字段——Spring 管不着，字段永远为null -
@Configuration类里的@Bean方法，其参数能被自动注入，是因为 Spring 在解析配置类时做了特殊处理，不是注解本身的能力
重复注解需用 @Repeatable 声明容器，否则编译报错
Java 8 以前不支持同一位置多个相同注解，现在可以，但语法有硬性要求。
- 必须定义一个“容器注解”，比如
@MyAnnos，其value()返回MyAnno[] - 原注解上加
@Repeatable(MyAnnos.class) - 使用时可写多次：
@MyAnno("v1") @MyAnno("v2")，反射读取时用getAnnotationsByType(MyAnno.class)，不能用getAnnotation()
漏掉 @Repeatable 却写了两个同名注解？编译器直接报错：Duplicate annotation。
最常被忽略的一点：注解属性类型受限严格——只能是基本类型、String、Class、枚举、其他注解，或以上类型的数组；不能是任意对象，也不能有方法体或泛型参数。试图绕过这些限制，只会让编译失败或运行时异常。
