注解是嵌入类文件的结构化元数据，本质为继承Annotation的接口；需厘清“谁定义、在哪用、怎么读、何时生效”四主线，依赖@Target/@Retention等元注解声明规则，用于编译检查、框架配置和运行时反射。
Java 注解系统梳理，关键不是背注解列表，而是理清“谁定义、在哪用、怎么读、何时生效”这四条主线。掌握这套逻辑，就能从零散记忆转向结构化理解。
注解到底是什么？
它不是语法糖，也不是运行时代码，而是一段嵌入在类文件里的结构化元数据（metadata）。本质是编译器生成的、继承自 java.lang.annotation.Annotation 的特殊接口。它不执行逻辑，但能被工具或框架“看见”并触发行为——比如 Spring 用 @Autowired 找 Bean，JUnit 用 @Test 发现测试方法。
元注解：注解的“说明书”
所有自定义注解都依赖四个核心元注解来声明自身规则：
-
@Target：限定能标在哪（如ElementType.METHOD表示只能加在方法上） -
@Retention：决定活多久（RUNTIME最常用，保证反射能读到） -
@Documented：控制是否出现在生成的 JavaDoc 里 -
@Inherited：仅对类注解生效，子类可自动继承（方法注解不继承）
没配 @Retention(RUNTIME) 的注解，反射读不到；没配 @Target 的注解，IDE 不会提示错误位置——这两项漏掉，自定义注解基本等于废。
三类典型使用场景
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
编译期检查：如
@Override让编译器验证重写正确性，@SuppressWarnings("unchecked")主动压制泛型警告 -
框架驱动配置：Spring 中
@Service触发组件扫描，@Transactional在运行时织入事务代理 -
运行时动态行为：通过反射获取注解信息，实现权限校验、参数校验、日志埋点等。例如：
if (method.isAnnotationPresent(RequirePermission.class)) { String[] perms = method.getAnnotation(RequirePermission.class).value(); checkPermission(perms); }
组合注解：让语义更清晰
Spring 大量使用组合注解降低认知成本。比如 @SpringBootApplication 并非魔法，而是三个注解的打包：
-
@Configuration（启用配置类） -
@EnableAutoConfiguration（触发自动装配） -
@ComponentScan（扫描组件）
你也可以封装自己的组合注解，用@AliasFor桥接属性，把@RestController + @RequestMapping + @CheckAuth合成一个@V1SecureApi，既统一规范，又避免重复。
不复杂但容易忽略
立即学习“Java免费学习笔记（深入）”；
