Java中合法的record声明必须显式列出所有组件字段，如public record Person(String name, int age) {}；不能省略括号内组件、不能添加非static实例字段、不能继承或定义无参构造器。
Record类怎么声明才合法
Java的record不是普通类，它本质是不可变的数据载体，编译器会强制约束结构。声明时必须显式列出所有组件字段，且不能有无参构造器、不能继承其他类、不能声明实例字段（static字段除外）。
- 正确写法：
public record Person(String name, int age) {}—— 组件列表即构造参数，也自动成为public final字段 - 错误写法：
public record Person { String name; int age; }—— 缺少括号内组件声明，编译报错error: record must declare at least one component - 错误写法：
public record Person(String name, int age) { private String id; }—— 非static实例字段不被允许，编译报错error: illegal instance field declaration in record
什么时候该用record而不是class
record适合表达“纯数据、无行为、不可变”的场景，比如DTO、API响应体、配置片段、函数返回值封装。一旦你需要逻辑方法、状态变更、复杂构造逻辑或与框架深度集成（如JPA实体），就该退回到class。
- 适合：
record ApiResponse<t>(int code, String message, T data) {}</t>—— 简洁、线程安全、自动equals/hashCode/toString - 不适合：
record User(String username, String passwordHash)—— 密码哈希不该暴露为公开字段，且可能需要校验逻辑 - 注意：Lombok的
@Data在record上无效，IDE可能误提示“可以简化”，别信
record的equals和hashCode到底怎么算
record的equals和hashCode只基于组件字段（即声明括号里的那些），按声明顺序逐个比较。它不看transient字段（但record根本不允许transient实例字段），也不看static字段，更不会递归检查嵌套对象的深层内容。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 组件字段是引用类型时，调用其自身的
equals—— 所以如果嵌套了自定义class，得确保它自己实现了合理equals -
record Point(int x, int y) {}和record Point(Integer x, Integer y) {}行为不同：后者在x == null时可能NPE，前者不会（int是基本类型） - 别试图重写
hashCode——编译器生成的实现已最优；若强行重写，record语义就被破坏，IDE会警告record component-based implementation is expected
record在JSON序列化里容易出什么问题
主流库（Jackson 2.12+、Gson）默认支持record，但细节差异大。Jackson靠ParameterNamesModule或@ConstructorProperties识别构造器参数，而record的构造器参数名天然可用；Gson需启用GsonBuilder.setExclusionStrategies以外的配置，默认可能漏字段。
立即学习“Java免费学习笔记（深入）”；
- Jackson推荐配置：
new ObjectMapper().registerModule(new ParameterNamesModule())—— 否则可能反序列化失败，报错Cannot construct instance of X - Gson默认不支持record（老版本），必须升级到
2.10+并确保没禁用jdk8模块 - Spring Boot 2.6+ 默认启用Jackson对record的支持；但若手动配置
ObjectMapper，忘了注册ParameterNamesModule，接口返回record就会空字段
record看着简单，但它的不可变性、组件绑定、以及框架适配点，全卡在声明那一行括号里。多一个空格、少一个参数、错用一个修饰符，编译器就立刻打断你——这不是限制，是它在帮你守住数据契约的边界。
