@Target是Java中指定注解作用域的元注解，接收ElementType枚举数组，常见值包括TYPE、METHOD、FIELD、PARAMETER、LOCAL_VARIABLE、ANNOTATION_TYPE、PACKAGE、TYPE_PARAMETER和TYPE_USE，需根据语义合理组合以保障类型安全与可复用性。
@Target 是 Java 中用于指定注解可以应用在哪些程序元素上的元注解。它接收一个 ElementType 枚举数组，控制该注解的“作用域”。正确配置 @Target 是设计可复用、语义清晰、类型安全注解的关键一步。
常见 ElementType 枚举值及适用场景
每个枚举值代表一种可被注解标记的语法结构：
-
TYPE：类、接口、枚举、注解类型（如
@interface） - METHOD：方法声明（含普通方法、构造器、默认方法、静态方法）
- FIELD：字段（含 enum 常量、static final 常量），不包括局部变量
- PARAMETER：方法或构造器参数
- LOCAL_VARIABLE：局部变量（含 for 循环中声明的变量）
-
ANNOTATION_TYPE：仅用于注解类型的声明（即标注在
@interface上） - PACKAGE：包声明（需配合 package-info.java 使用）
-
TYPE_PARAMETER：泛型类型参数（如
<T extends @MyAnno Object>中的T） -
TYPE_USE：任意类型使用处（如泛型边界、强制转换、
new表达式、throws子句等），是 Java 8 引入的“宽泛型”目标
典型配置组合示例
根据注解用途选择合理的组合，避免过度开放导致误用：
- 日志埋点注解（只修饰方法）：
@Target(ElementType.METHOD) - 非空校验注解（可用于参数和字段）：
@Target({ElementType.PARAMETER, ElementType.FIELD}) - 自定义序列化策略注解（支持字段、方法、类型）：
@Target({ElementType.FIELD, ElementType.METHOD, ElementType.TYPE}) - 泛型约束注解（如限制类型参数必须支持某种行为）：
@Target({ElementType.TYPE_PARAMETER, ElementType.TYPE_USE}) - 包级配置注解（如框架默认扫描路径）：
@Target(ElementType.PACKAGE)（需写在package-info.java中）
易错点与最佳实践
配置不当会导致编译错误或运行时不可预期行为：
- 不要遗漏 ANNOTATION_TYPE —— 若希望自定义注解能被其他注解标记（如
@Repeatable或自定义元注解），需显式添加 - 慎用 TYPE_USE：它覆盖范围极广，可能让注解出现在开发者未预料的位置（如
(@MyAnno String) obj），应结合语义判断是否真需如此灵活 - 避免冗余组合：例如
@Target({METHOD, TYPE})用于“仅限方法”的注解，会降低类型安全性，编译器无法阻止误标在类上 - 若注解本身是元注解（如定义自己的
@MyRepeatable），通常需同时声明ANNOTATION_TYPE和TYPE
完整注解接口定义示例
一个用于标记“实验性 API”的注解，允许标注在类、方法、字段，并支持在泛型使用处启用：
@Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Experimental {
String value() default "";
String since() default "1.0";
}
这样既满足核心使用场景，又为未来在类型上下文（如 List<@Experimental String>）中扩展留出空间，而不会放任其出现在局部变量或包声明等无关位置。
