Java元注解详解：@Target、@Retention、@Documented与@Inherited-代码聚汇网

Java元注解详解：@Target、@Retention、@Documented与@Inherited

优普道建筑网校·2026-05-21·阅读 43 GEO检测（免费）

Java元注解@Target@Retention

|难度：普通|阅读约 20 分钟

1. 元注解基础概念解析

在Java开发中，元注解（Meta-Annotation）是定义其他注解行为的特殊注解。它们就像是注解的"宪法"，规定了注解的基本属性和行为准则。理解元注解对于编写高质量的自定义注解至关重要。

元注解主要包含以下四种核心类型：

这些元注解都位于java.lang.annotation包中，是Java注解体系的基础构件。它们协同工作，共同定义了自定义注解的各种行为特征。

提示：在Java 5.0引入注解功能时，这四种元注解就已经存在。它们是Java注解体系的基石，后续版本中也没有新增其他元注解类型。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

@Target注解通过ElementType枚举来指定注解可以应用的位置。以下是完整的ElementType取值及其含义：

ElementType值	适用位置	典型应用场景
TYPE	类、接口、枚举声明	Spring的@Service、@Controller
FIELD	字段声明	JPA的@Column、@Id
METHOD	方法声明	JUnit的@Test、Spring的@RequestMapping
PARAMETER	方法参数	Spring的@RequestParam
CONSTRUCTOR	构造方法	特定构造方法标记
LOCAL_VARIABLE	局部变量	代码分析工具使用
ANNOTATION_TYPE	其他注解	元注解本身（如@Target）
PACKAGE	包声明	包级别配置
TYPE_PARAMETER	类型参数	Java 8新增，泛型类型参数
TYPE_USE	类型使用	Java 8新增，任何类型使用处

@Target支持同时指定多个位置，这在开发通用注解时非常有用：

java复制@Target({ElementType.METHOD, ElementType.TYPE})
public @interface Loggable {
    // 可以同时用于类和方法
}

这种灵活性使得我们可以设计出适用性更广的注解。例如Spring的@RequestMapping就可以同时应用于类和方法，分别表示控制器基路径和方法级路径。

选择正确的@Target需要考虑以下因素：

例如，一个用于方法性能监控的注解应该只限定在METHOD上，而不是可以随意用在字段