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(隐式或显式):
public readonly record struct Person(string Name, int Age);
这样就自动生成了:
- 只读字段
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);
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 Value, bool Success);
基本上就这些。record struct 不复杂但容易忽略它的值语义和 readonly 强制性——把它当成“带自动契约的轻量数据包”来用最自然。










