@Target元注解通过ElementType枚举指定自定义注解的合法标注位置，编译期强制校验；常用值包括TYPE、METHOD、FIELD等，Java 8起新增TYPE_PARAMETER和TYPE_USE支持类型使用场景，Java 9+新增MODULE和RECORD_COMPONENT。

@Target 元注解通过 ElementType 枚举值来明确指定自定义注解可以标注在哪些程序元素上。这些枚举值覆盖了 Java 源码中所有合法的声明位置和类型使用场景，不是运行时校验规则，而是在编译期由 javac 强制检查——写错位置会直接报错。

常用 ElementType 值及其适用位置

以下是最常使用的 ElementType 枚举项，对应典型开发场景：

• TYPE：类（class）、接口（interface）、枚举（enum）、注解类型（@interface）、记录（record）等顶层类型声明。不包括内部类（除非额外加 TYPE_USE）。
• METHOD：方法声明，比如用于 AOP 切面、权限控制、日志埋点等。
• FIELD：字段（含枚举常量），常用于数据校验（如 @NotNull 标在 DTO 字段上）或 ORM 映射（如 @Column）。
• PARAMETER：方法或构造器的形参，适合 Controller 层参数校验或依赖注入标记。
• CONSTRUCTOR：构造器声明，可用于约束对象创建方式或配合工厂模式。
• LOCAL_VARIABLE：局部变量，较少用，但可用于代码分析工具提示或特定编译检查。
• ANNOTATION_TYPE：仅用于修饰其他注解（即元注解自身），例如 @Target 自身就标有 @Target(ElementType.ANNOTATION_TYPE)。
• PACKAGE：包声明（package-info.java 中），用于包级文档或配置。

Java 8+ 新增的重要类型上下文

从 Java 8 开始，ElementType 扩展了对“类型使用”（type use）的支持，不再局限于声明处：

javascript-typescript-typescript-scaffold

你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型

下载

• TYPE_PARAMETER：泛型类型参数声明，如 class Box 中的 T。
• TYPE_USE：任何类型被使用的位置，包括：
  • 变量/字段/形参的类型（@NonNull String name）
  • 泛型实参（List）
  • 强制类型转换（(@NonNull Object) obj）
  • throws 子句中的异常类型（void method() throws @Checked Exception）

Java 9+ 及后续版本补充项

为适配新语言特性，新增了更细粒度的定位能力：

• MODULE：模块声明（module-info.java），用于 JPMS 模块系统。
• RECORD_COMPONENT：记录（record）的组件（即构造参数和字段），Java 16 引入，支持对 record 成员单独加注解。

@Target 支持组合写法

一个注解可同时作用于多个位置，只需传入 ElementType 数组：

@Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.FIELD})
表示该注解既可标在方法上，也可标在构造器或字段上。没有默认值，必须显式指定，否则编译失败。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南