注解是程序可读的元数据而非注释，需处理器（如编译器、反射）才生效；自定义注解须声明@Target、@Retention及合法属性，运行时读取需反射并判空。
注解本身不执行任何逻辑，它只是代码的“标签”——就像你给文件夹贴上“紧急”便签，便签不会自动帮你做事，但你能一眼识别优先级；同理，@Override 不重写方法，@Deprecated 不禁用方法，它们只提供元数据，真正起作用的是编译器或运行时读取这些标签后做的判断和处理。
注解不是注释，是程序可读的元数据
很多人第一眼把 @Override 当成高级注释，这是最大误区。注释（// 或 /** */）在编译时被完全丢弃，JVM 看不见；而注解默认保留在 .class 文件里（@Retention(RetentionPolicy.CLASS)），甚至能活到运行时（RUNTIME），供反射调用。
- 注释 → 给人看，编译器无视
- 注解 → 给程序看，必须有处理器（编译器、APT、反射）才生效
- 没写处理器的自定义注解，就等于贴了张没人认的标签——语法合法，但毫无作用
自定义注解三要素：@Target、@Retention、属性声明
定义一个可用的注解，光写 @interface MyAnno 不够，必须明确：它能标在哪（类？方法？参数？）、保留到哪一阶段（源码？字节码？运行时？）、带哪些参数。
-
@Target({ElementType.METHOD, ElementType.TYPE})：限制只能用在方法或类上，标在字段会编译报错 -
@Retention(RetentionPolicy.RUNTIME)：这是反射读取的前提；若设为SOURCE，连.class里都没有，反射必然拿不到 - 属性必须是接口方法形式，返回类型受限（基本类型、String、Class、枚举、其他注解、以上类型数组），不能是
List或自定义对象
import java.lang.annotation.*;@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface LogExecutionTime { String value() default "default"; int thresholdMs() default 100; }
运行时读取注解必须靠反射，且要检查存在性
即使注解保留策略是 RUNTIME，也不代表一定能读到——你得先拿到目标元素的反射对象（Class、Method、Field），再调用 getAnnotation()。漏掉 isAnnotationPresent() 直接强转，容易抛 NullPointerException。
立即学习“Java免费学习笔记（深入）”；
- 类上的注解：用
clazz.getAnnotation(MyAnno.class) - 方法上的注解：先
Method m = clazz.getDeclaredMethod("xxx");，再m.getAnnotation(MyAnno.class) - 务必判空：反射返回
null是常态，不是异常
常见踩坑点：value 属性可省略，但其他属性不行
当注解只有一个名为 value 的属性，且你只传这一个值时，可以省略 value=：
-
@LogExecutionTime("api")✅ 等价于@LogExecutionTime(value="api") -
@LogExecutionTime(thresholdMs=50)❌ 编译失败：非value属性必须显式写出名 - 多个属性必须全写，且顺序无关：
@LogExecutionTime(value="cache", thresholdMs=200)
另外，数组属性写法易错：@MyAnno(tags={"a","b"}) 中的花括号不能省，单元素也要写成 {"x"}，否则编译不通过。
