java注解是编译期和运行时可读的元数据载体，本质为标记而非逻辑执行者，其生效依赖编译器、apt或反射，生命周期由@retention控制，自定义需明确@target、@retention及属性定义，运行时处理应结合反射并注意性能与类加载问题。
Java 注解（Annotation）不是代码的“装饰品”，而是编译期和运行时可读的元数据载体，用得好能大幅简化重复逻辑、提升可维护性、支撑框架自动装配。关键不在记多少注解，而在理解它何时生效、谁来处理、怎么自定义。
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
注解的本质与生命周期
注解本身不执行任何逻辑，它只是标记——像一张贴在类、方法或字段上的便签。真正起作用的是“读取并响应这张便签”的程序：可能是编译器（如 @Override 检查）、注解处理器（APT，在编译期生成代码）、或是运行时通过反射获取（如 Spring 的 @Autowired）。Java 通过 @Retention 控制注解存活时间：
• @Retention(RetentionPolicy.SOURCE)：仅保留在源码中，编译后丢弃（如 @Override）
• @Retention(RetentionPolicy.CLASS)：存入 .class 文件但不加载进 JVM（较少用）
• @Retention(RetentionPolicy.RUNTIME)：完整保留，可通过反射读取（绝大多数自定义注解需设为此）
常用内置注解与典型误用
别把 @Override 当成可有可无的“礼貌”——它强制编译器检查是否真重写了父类/接口方法，漏写可能引入静默错误；@Deprecated 不只是加个删除线，配合 @SuppressWarnings("deprecation") 才能精准抑制警告；@SuppressWarnings 要指定具体警告类型（如 "unchecked"），避免掩盖真实问题。另外：
• @FunctionalInterface 只校验接口是否符合函数式接口定义，不保证 lambda 安全
• @SafeVarargs 仅用于无泛型擦除风险的 varargs 方法，不能乱加
自定义注解三要素
写一个可用的注解，必须明确三件事：
• 作用范围：用 @Target 指定能标注在哪（如 ElementType.METHOD、ElementType.TYPE）
• 保留策略：用 @Retention 指定生命周期（通常选 RUNTIME）
• 属性定义：用方法声明属性（返回值类型限于基本类型、String、Class、枚举、其他注解或其数组），默认值用 default 关键字（如 String value() default ""）
运行时注解处理实战要点
想让自定义注解在运行时起作用，核心是反射 + 判断 + 处理：
• 先用 isAnnotationPresent(Class extends Annotation>) 快速判断是否存在该注解
• 再用 getAnnotation(Class
• 注意：若注解属性含 Class 类型，反射获取时需确保类已加载，否则抛 NoClassDefFoundError
• 避免在高频调用路径（如循环内）反复反射读取——可提前缓存解析结果
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
