@Target的取值包括TYPE、METHOD、FIELD、PARAMETER、CONSTRUCTOR、LOCAL_VARIABLE、ANNOTATION_TYPE、PACKAGE、TYPE_PARAMETER、TYPE_USE;分别用于类/接口/枚举、方法、字段、形参、构造器、局部变量、注解声明、包声明、泛型类型参数、所有类型使用处。

@Target 的取值有哪些?分别能用在哪儿?
@Target 通过 ElementType 枚举限定注解可标注的语法位置。Java 编译器会严格校验,写错或用错位置直接报错,不给运行机会。
常用取值及对应适用场景:
- TYPE:类、接口、枚举、注解类型本身(比如定义一个只能加在类上的 @Service)
- METHOD:方法声明(如 @LogExecutionTime 只允许标在方法上)
- FIELD:字段(含 public/private/protected 成员变量、枚举常量)
- PARAMETER:方法或构造器的形参(常用于参数校验,如 @NotNull String name)
- CONSTRUCTOR:构造方法(如限制某注解只能修饰构造器)
- LOCAL_VARIABLE:局部变量(如 for 循环变量、catch 中的异常参数)
- ANNOTATION_TYPE:仅用于其他注解的声明(即“注解的注解”,属于元注解)
- PACKAGE:仅用于 package-info.java 中的包声明(如 @PackagePrivate)
- TYPE_PARAMETER:泛型类型参数(如 class Box<@NonNull T>)—— Java 8+ 支持
- TYPE_USE:所有“使用类型”的地方,包括泛型实参(List<@NonNull String>)、new 表达式(new @Immutable ArrayList<>())、类型转换((@NonNull String) obj)、throws 子句等——Java 8+ 新增,常需与 TYPE 等配合使用
写法要注意什么?常见错误有哪些?
语法上必须传 ElementType 数组,哪怕只写一个值,也得用大括号包住:
- ✅ 正确:@Target({ElementType.METHOD}) 或 @Target({ElementType.METHOD, ElementType.FIELD})
- ❌ 错误:@Target(ElementType.METHOD)(少一层大括号,编译失败)
- ❌ 错误:@Target({ElementType.TYPE_USE}) 却试图把注解加在类上(TYPE_USE 不覆盖 TYPE,需显式加上)
比如想让注解既能标在方法上,也能用于泛型类型实参,就得写:
@Target({ElementType.METHOD, ElementType.TYPE_USE})
@Target 和 @Retention 是什么关系?
两者职责分明、互不替代:
- @Target 管“能不能写”——编译期语法检查,写错位置立刻报错
- @Retention 管“还在不在”——决定注解保留在源码(SOURCE)、字节码(CLASS)还是运行时(RUNTIME)
例如:
@Retention(RetentionPolicy.SOURCE) @Target(ElementType.ANNOTATION_TYPE)
表示:这个注解只能用来标注别的注解,且编译完就丢弃,反射永远读不到。
反过来,如果注解需要运行时反射处理(如 Spring AOP),却忘了写 @Retention(RUNTIME),
clazz.getAnnotation(MyAnno.class) 永远返回 null,而且没有任何提示。
怎么选才合适?实用建议
根据注解用途决定组合方式:
- 做编译期检查(如 Lombok、APT 工具):@Retention(SOURCE) + 精准 @Target(如 PARAMETER 或 TYPE_PARAMETER)
- 做运行时增强(如 Spring 的 @Transactional、自定义拦截):@Retention(RUNTIME) + 明确作用域(如 METHOD 或 TYPE)
- 涉及泛型/类型转换等精细控制:必须包含 TYPE_USE,必要时叠加 TYPE、METHOD 等
- 定义元注解(比如自己写个 @MyTarget):@Target(ANNOTATION_TYPE) 是标配










