“Java 注解全景指南”是开发者实践沉淀的系统性注解知识结构，按框架归属（如@TableName属MyBatis-Plus、@Value属Spring）、核心属性必要性（如@Excel的name常必需）及组合逻辑（如@Valid需配合嵌套类约束）三方面展开。
直接读，别绕弯。
“Java 注解全景指南”不是一本书名，也不是某个固定文档的标题，而是对 Java 中各类注解用法的一次系统性梳理。它没有统一出版物，而是开发者在实践中逐步沉淀出的知识结构——你可以把它理解为一张“注解地图”，按功能分块、按框架归类、按场景落地。
重点看三块内容：
谁在用、在哪用
比如@TableId是 MyBatis-Plus 专属，只出现在实体类字段上；@Excel属于 EasyPoi，只在导出/导入 DTO 里生效；@Value是 Spring 的，专用于从配置中取值；@Valid来自 Jakarta Bean Validation，必须配合控制器参数或嵌套对象使用。先确认注解归属框架，再查对应文档，不混用。核心属性是否必要
不是所有属性都要写。@TableName("user")通常只需 value；@Excel(name = "姓名")中 name 常不可少，但 orderNum 或 fixedIndex 只在列序易变或存在重名时才启用；@TableField(exist = false)这种显式排除，比靠命名约定更可靠。组合逻辑比单个注解更重要
比如逻辑删除不是只加@TableLogic就完事，还得配全局配置（如logic-delete-value=1、logic-not-delete-value=0）；自动填充要搭配MetaObjectHandler实现；@Valid验证嵌套对象时，被嵌套类字段也得有@NotNull等约束注解，否则级联无效。
读的时候，建议带着具体问题切入：
要导出 Excel？重点看 @Excel 和 @ExcelCollection；
刚接入 MyBatis-Plus？先搞懂 @TableName、@TableId、@TableField；
接口参数要校验？盯住 @Valid + jakarta.validation 注解组合；
配置项要动态注入？@Value 的 SpEL 表达式和 @ConfigurationProperties 的区别得厘清。
不复杂但容易忽略。
立即学习“Java免费学习笔记（深入）”；
