@target 是注解设计的第一道防线，通过 elementtype 精准限定使用位置，实现编译期检查：type 覆盖类、接口、枚举、注解类型（含 record），method 限于方法，parameter 限于形参，local_variable 限于局部变量，多位置需显式枚举而非用 elementtype.*。
注解的 @Target 元素不是装饰性标签，而是对使用位置的强制约束——它告诉编译器“这个注解只能出现在这里”，从而在编译期拦截不合理的用法，避免运行时隐晦错误。
限定在类或接口声明上
当注解用于标识某种类型级别的契约（如 @RestController 或自定义的 @DomainEntity），应明确限定为 ElementType.TYPE。这样能防止开发者误将其加到方法、参数甚至包上。
- 写法示例：
@Target(ElementType.TYPE) - 若同时支持类和接口，无需额外操作——
TYPE已涵盖class、interface、enum和annotation type - 注意：不包含
record（Java 14+）？实际包含——ElementType.TYPE覆盖所有类型声明
只允许标注方法
面向行为的注解（如权限校验 @RequiresRole、缓存控制 @Cacheable）必须限制在方法级，否则语义错乱。用 ElementType.METHOD 可杜绝加在字段或类上的误用。
- 常见误区：把本该作用于方法的注解设成
ElementType.TYPE，结果导致整个类被统一处理，失去粒度控制 - 若还需支持构造方法，可叠加：
@Target({ElementType.METHOD, ElementType.CONSTRUCTOR}) - 不要为了“灵活”而写
ElementType.*—— 缺乏约束等于放弃编译期检查
精准控制到参数或局部变量
像 @NotNull 这类校验注解，核心价值在于绑定具体参数或变量。若不限定 ElementType.PARAMETER 或 ElementType.LOCAL_VARIABLE，就可能被错误地贴在返回值或类上，失去校验意义。
-
PARAMETER保证只用于方法/构造器形参；LOCAL_VARIABLE对应final变量或普通局部变量 - 注意：
ElementType.FIELD不等价于PARAMETER——前者针对成员变量，后者针对入参，用途截然不同 - IDE（如 IntelliJ）会依据
@Target提供智能提示和实时报错，这是提升协作效率的关键信号
组合多个合法位置
有些注解天然具备多场景语义，比如日志注解 @LogExecutionTime 既可用于方法（记录执行耗时），也可用于类（对所有方法生效）。这时需显式列出所有允许位置。
- 写法：
@Target({ElementType.METHOD, ElementType.TYPE}) - 避免模糊写法：
@Target(ElementType.TYPE)+ 注释说明“也支持方法”——编译器不认注释，只有元数据才有效 - 组合时顺序无关，但建议按常用程度排列（如 METHOD 在前，TYPE 在后），便于快速识别主用场景
不复杂但容易忽略——@Target 是注解设计的第一道防线，它让意图可见、错误提前、协作顺畅。
