C# 10 中的 record Struct 是轻量级、不可变、值语义的结构类型,自动实现相等比较、ToString 等,需显式或隐式 readonly,不支持 with 表达式和 继承,适用于小数据模型与高性能场景。

在 C# 10 中,record struct 是一种轻量级、不可变(默认)、值语义的结构类型,适合用于数据载体(如 DTO、返回值、配置项等),相比 class-based record 更省内存、避免 堆分配,也比普通 struct 更易用(自动实现 Equals、GetHashCode、ToString 和 ==/!=)。
record struct 基本写法
语法和 record class 类似,但用 struct 关键字替代 class,且必须是 readonly(隐式或显式):
这样就自动生成了:
- 只读字段
Name和Age - 位置 构造函数(可直接传参初始化)
- 基于值的相等比较(
==/!=) - 重写的
Equals、GetHashCode、ToString - 解构支持(
var (name, age) = person;)
带命名字段和自定义成员的 record struct
你也可以显式声明字段、属性,甚至添加方法或自定义 ToString:
public readonly record struct Point(double X, double Y) {public double DistanceFromOrigin => Math.Sqrt(X * X + Y * Y); <pre class="brush:php;toolbar:false;">public override string ToString() => $"({X:F2}, {Y:F2})";
}
注意:所有字段 / 属性仍需保持只读(init 或 get-only),否则编译报错。不支持 with 表达式(这是 record class 的特性,record struct 没有引用语义,也不需要“复制并修改”)。
和普通 struct、record class 的关键 区别
- vs 普通 struct:不用手动实现
Equals/GetHashCode,不用写构造函数和ToString,语义更清晰 - vs record class:值类型 ( 栈分配)、不可继承、无
with、无Deconstruct自动生成(除非显式写)、不能为NULL(除非是可 空类型 如Person?) - 适用场景 :小数据模型(如坐标、颜色、http 状态码 包装、API 响应体片段)、函数式风格参数传递、高性能路径中的临时值 对象
使用注意事项
- 必须加
readonly(C# 10 要求;省略会编译失败) - 不能包含字段初始化器(如
int count = 0;),但可以用init属性或构造函数赋值 - 不支持继承(不能
: BaseRecord),也不能被继承 - 泛型 支持良好:
public readonly record struct Result<t>(T Value, bool Success);</t>
基本上就这些。record struct 不复杂但容易忽略它的值语义和 readonly 强制性——把它当成“带自动契约的轻量数据包”来用最自然。