在 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);
<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 强制性——把它当成“带自动契约的轻量数据包”来用最自然。
