@Target是Java中限定自定义注解适用位置的元注解,通过ElementType枚举值(如TYPE、METHOD、FIELD等)约束其使用范围,配合@Retention可精确控制注解生命周期。
@Target 是 Java 中的一个元注解(meta-annotation),用来**限定自定义注解可以被用在哪些程序元素上**。它不提供功能逻辑,只起“约束作用”——告诉编译器:这个注解只能写在类、方法、字段、参数等特定位置,否则编译报错。
它能限制哪些地方?
通过 @Target 的 value 参数,传入一个或多个 ElementType 枚举值,比如:
- ElementType.TYPE:类、接口、枚举
- ElementType.METHOD:方法声明
- ElementType.FIELD:成员变量(字段)
- ElementType.PARAMETER:方法参数
- ElementType.LOCAL_VARIABLE:局部变量(Java 8+ 支持)
- ElementType.ANNOTATION_TYPE:用在其他注解上(即元注解)
怎么写一个带 @Target 的自定义注解?
定义时直接在注解上加 @Target,例如:
@Target(ElementType.METHOD)
public @interface LogExecutionTime {
}
这样写完后,LogExecutionTime 只能标注在方法上。如果强行写在类上:
@LogExecutionTime // 编译错误!
public class UserService { ... }
编译器会提示:“Annotation '@LogExecutionTime' is not applicable to this kind of decl

常见组合写法
一个注解常支持多种位置,用大括号包住多个 ElementType:
@Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.FIELD})
public @interface NotNull {
}
上面的 @NotNull 就允许用在方法、构造器、字段三处。注意:不能省略大括号,即使只有一个类型也要写成 @Target(ElementType.METHOD)(这是语法要求)。
和 @Retention 有什么区别?
@Target 管“能写在哪”,@Retention 管“保留到什么时候”(源码期、编译期、运行期)。两者经常一起出现:
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Retryable {
int maxAttempts() default 3;
}
这表示:该注解只能用于方法,且在运行时可通过反射读取。
基本上就这些。用对 @Target,能让注解更安全、更清晰,避免误用。








