@target 用于精准限定注解生效位置而非放宽限制，常见组合包括方法+字段（审计）、类+方法（aop）、方法+参数（校验）等；java 8 的 type_parameter 和 type_use 需显式声明；数组写法不可省略大括号，且需结合 @retention 正确配置生命周期。
@Target 不是用来“放宽限制”的，而是通过合理组合 ElementType 值，让注解刚好覆盖它真正需要生效的位置——不多不少。通用性不等于无差别开放，而是精准支持多种必要场景。
明确常用位置组合及其典型用途
多数业务注解不需要全量支持，但几个高频组合值得熟记：
- 方法 + 字段：适合审计、敏感标记类注解，比如 @Sensitive，既可标在 getPhone() 方法上，也可直接标在 private String phone 字段上
- 类 + 方法：AOP 场景最常见，如 @Transactional 允许加在整个 Service 类上（统一事务），也允许加在某个 updateOrder() 方法上（细粒度控制）
- 方法 + 参数：校验类注解的核心组合，例如 @ValidatedParam 可用于 void create(@ValidatedParam User u) 中的参数，也可用于整个方法入口做批量校验
- 类 + 构造器 + 参数：DI 框架常用，如自定义 @Injectable 注解，需支持类级注入、构造器注入、以及构造参数上的元数据
Java 8 新增类型必须显式声明
TYPE_PARAMETER 和 TYPE_USE 不会自动包含在 TYPE 或 METHOD 中，哪怕你写了 @Target({ElementType.TYPE})，也无法用在 class Box 或 List 上。
- 要支持泛型形参声明（如 ），必须加上 ElementType.TYPE_PARAMETER
- 要支持任意类型使用处（如 new @Immutable ArrayList()、(String) obj、instanceof @NotNull Object），必须加上 ElementType.TYPE_USE
- 二者常搭配使用：@Target({ElementType.TYPE, ElementType.TYPE_PARAMETER, ElementType.TYPE_USE}) 是泛型安全注解的标准写法
避开常见语法与逻辑陷阱
写错一个括号或漏掉一个类型，轻则编译失败，重则注解“静默失效”：
- 数组写法不可省略大括号：@Target({ElementType.METHOD}) ✅，@Target(ElementType.METHOD) ❌（编译报错）
- 内部类属于 TYPE，但默认不被 TYPE 覆盖；若需支持，得单独加 ElementType.TYPE（内部类本质仍是 type）
- PACKAGE、ANNOTATION_TYPE、MODULE 等冷门类型虽少用，但一旦涉及模块化或包级元数据，缺一不可
- @Target 和 @Retention 各司其职：前者管“能写在哪”，后者管“能活到哪”；只设 @Target 不设 RUNTIME，反射读不到；只设 RUNTIME 不设 @Target，注解本身就不合法
结合实际场景判断是否真需多目标
不是所有注解都该“通用”。盲目堆砌 ElementType 反而降低可维护性：
- 日志注解 @LogEntry 若同时允许标在字段和局部变量上，语义就模糊了——字段记录的是状态，局部变量记录的是瞬时值，处理逻辑可能完全不同
- 权限注解 @RequiresRole 更适合限定在 METHOD 或 TYPE，标在 PARAMETER 上容易引发歧义（是参数需权限？还是调用者需权限？）
- 真正需要多目标，往往是因为底层处理逻辑一致：比如序列化注解 @SerializeAs，无论出现在字段、方法返回值、还是泛型参数中，都只需告诉序列化器“这里该怎么转”
