Java14记录类详解与使用方法

Java 14 引入的 record 并非普通类的语法糖，而是一种专为不可变数据建模设计的轻量级类型——它强制声明至少一个组件字段、隐式 final、不可继承、自动实现基于值的 equals/hashCode/toString，并要求所有自定义构造器必须严格委托给规范构造器；但正因其“扁平、明确、不可扩展”的本质，误将其当作空标记、可变容器或继承结构基类将导致编译失败或运行时陷阱，真正用好 record 的关键在于理解并坚守其不可变契约：优先选用不可变字段类型、避免可变集合裸露、通过组合替代继承，让数据意图清晰可见、行为稳定可预测。

Record 类必须有至少一个字段

Java 的 record 不是普通类的语法糖，它本质是不可变的数据载体，编译器会强制你声明至少一个组件字段。如果写成 record EmptyRecord {}，javac 直接报错：error: record must declare at least one component。

常见误用是想定义一个“标记型 record”来替代枚举或空接口，这行不通。真需要语义标记，用 enum 或 interface；真要空数据结构，老实用 class。

• 字段名不能是 final、static、transient 等修饰符（编译器自动加 final）
• 字段类型可以是任意引用或基本类型，但建议避开可变类型（如 ArrayList），否则破坏“不可变”契约
• 构造函数参数顺序和字段声明顺序严格一致，不能重排

自定义构造函数时必须调用 canonical 构造器

record 允许定义额外构造器，但所有自定义构造器第一行必须显式调用 this(...)，且参数必须能映射到 record 声明的字段。比如：

record Point(int x, int y) {
    public Point(int x) {
        this(x, 0); // ✅ 正确：转发给 canonical 构造器
    }
    public Point() {
        this(0, 0); // ✅ 同样合法
    }
}

如果漏掉 this(...) 或调用普通方法，编译失败：error: call to super() or this() must be first statement。

• 不能在自定义构造器里对字段赋值（this.x = ... 非法），字段由 canonical 构造器统一初始化
• 如果字段有校验逻辑（如非负），只能放在 canonical 构造器里，用 private 构造器 + this(...) 转发实现
• IDE 自动生成的构造器补全通常不处理 record，别依赖它

record 的 equals/hashCode 是基于字段值，不是引用

record 自动重写 equals()、hashCode() 和 toString()，全部基于组件字段的值。这意味着两个不同实例只要字段值相同，equals 就返回 true —— 这和 String 行为一致，但和普通 class 默认行为完全不同。

容易踩的坑是把 record 当作“轻量 class”随意修改字段，结果发现 Set 里存了重复项，或者作为 Map key 时行为异常。因为 record 字段是 final，你改不了；但如果你字段里存了可变对象（比如 List），外部修改这个 list，hashCode() 结果就可能变，违反哈希契约。

• record 实例放进 HashSet 后，不要让它的任何字段指向的对象发生内容变更
• 字段类型优先选不可变类（String、LocalDate、其他 record），避免 ArrayList、HashMap
• 如果必须用可变集合，考虑在构造时做防御性拷贝：new ArrayList(inputList)

record 不能继承，也不能被继承

record 是 final 类，隐式 final，所以不能用 extends 继承其他类，也不能被其他类 extends。试图写 record A extends B 或 class C extends MyRecord，编译器直接拒绝：error: records are implicitly final and cannot extend other classes。

有人想用 record 模拟 DTO 继承结构（比如 UserRecord 和 AdminRecord 共享字段），这条路走不通。替代方案只有两个：

• 用组合：让 AdminRecord 包含一个 UserRecord 字段
• 放弃 record，退回普通 class，自己手写 equals/hashCode（或用 Lombok @Data）
• Java 16+ 支持 sealed 类配合 record，但 record 本身仍不能作为父类

record 的设计哲学就是“扁平、明确、不可扩展”，想搞层次结构，它就不是合适工具。

终于介绍完啦！小伙伴们，这篇关于《Java14记录类详解与使用方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！