@Target的作用是编译期限定注解可声明的语法位置，必须用ElementType[]数组形式指定，如@Target({ElementType.METHOD})，缺括号或枚举值错误将导致编译失败。

@Target 的作用是在编译期明确告诉 Java 编译器：这个注解只允许写在哪些语法位置上。写错地方，javac 直接报错，连 class 文件都不会生成。

必须用 ElementType 数组写法

哪怕只限制一个位置，也得用大括号包住枚举值，这是语法硬性要求：

• ✅ 正确：@Target({ElementType.METHOD})
• ✅ 正确：@Target({ElementType.TYPE, ElementType.METHOD})
• ❌ 错误：@Target(ElementType.METHOD)（缺大括号，编译失败）
• ❌ 错误：@Target({ElementType.TYPE_METHOD})（ElementType 没有这个枚举值）

常见位置组合与业务含义

选哪些 ElementType，取决于注解的实际用途，不是越多越好：

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• 只用于类、接口、枚举等顶层类型：用 @Target({ElementType.TYPE})。它天然覆盖 class、interface、enum、@interface，也包括 record（Java 14+）。
• 只用于方法声明：用 @Target({ElementType.METHOD})。适合权限、缓存、日志等行为级注解。
• 只用于方法或构造器参数：用 @Target({ElementType.PARAMETER})。校验类注解（如 @NotNull）常搭配 FIELD 一起用。
• 既要管整个类，又要管具体方法：显式组合，如 @Target({ElementType.TYPE, ElementType.METHOD})。Spring 的 @Transactional 就是典型例子。

必须搭配 @Retention 才完整

@Target 管“能不能写”，@Retention 才管“写了之后还在不在”：

立即学习“Java免费学习笔记（深入）”；

• 如果希望运行时通过反射读取（比如 AOP、参数绑定、框架扫描），必须加 @Retention(RetentionPolicy.RUNTIME)。
• 只加 @Target 不加 @Retention，或者用了 SOURCE/CLASS 策略，反射调用 getAnnotation() 会返回 null。
• 仅做编译检查（如 Lombok 提示），可用 SOURCE；但绝大多数自定义注解需要 RUNTIME。

验证是否生效的最快方式

不用跑程序，写个测试类，把注解故意贴到非法位置，看编译器是否报错：

• 贴在字段上 → 报错：“Annotation @XXX is not applicable to this kind of declaration”
• 贴在方法参数上 → 同样报错（如果 @Target 没包含 PARAMETER）
• 贴在类或方法上 → 通过（说明配置匹配）