C# Record Struct是什么 - C# 10.0带来的高性能数据结构

Record Struct适用于需高性能、值相等的小型不可变数据模型,如坐标、颜色等;它结合struct的栈分配与record的语义特性(值相等、ToString、解构、with表达式),避免GC开销,优于class record和普通struct,使用时应避免装箱、混用可变字段。

Record Struct 是 C# 10.0 正式引入的值类型记录结构,它把 struct 的栈分配、零 GC 开销优势,和 record 的语义能力(如值相等、自动 ToString、解构、with 表达式)结合在一起。不是语法糖,而是为性能敏感场景量身设计的轻量级不可变(或可控可变)数据载体。

核心定位:什么时候该用 Record Struct?

适合小而固定的数据模型,比如坐标、颜色、尺寸、时间区间、HTTP 状态码包装等。

  • 需要频繁创建/销毁,但又不想触发 GC —— 用 record struct 替代 class record 或普通 class
  • 数据天然按值比较(比如两个 Point(1,2) 应该 ==)—— 普通 struct 默认引用相等,record struct 自动实现值相等
  • 要享受 with 表达式带来的安全复制能力(如 point with { Y = 5 }),但又不愿承担引用类型的堆分配开销
  • 在 Span、ref struct 或高性能管道中传递结构化数据时,需保证不可变性与内存局部性

基本写法与关键细节

最简形式就是位置语法,编译器自动生成只读属性、构造函数、Equals/GetHashCode/ToString/Deconstruct:

public readonly record struct Point(int X, int Y);
  • 加 readonly 是推荐做法:显式声明不可变,避免意外赋值,也利于 JIT 优化
  • 不加 readonly 也能写,但会生成可变属性(public int X { get; set; }),失去 record 的核心契约
  • 支持继承其他 record struct(不能继承 class 或 record class),但实际中极少需要
  • 不支持无参构造函数或字段初始化器 —— 必须通过位置参数或显式属性初始化

和常见类型对比一目了然

同一组数据(X/Y 坐标),不同定义方式的行为差异:

  • 普通 struct:值类型,但 == 默认比较引用(对栈上值其实是逐字节比,但语义不明确),无 with,无解构支持
  • record class:引用类型,堆分配,GC 参与,适合生命周期长或较大对象;默认不可变 + 值相等
  • readonly struct:纯手工写的只读结构体,需手动实现 Equals/ToString/Deconstruct,易出错且冗长
  • record struct:值类型 + 编译器托管的 record 语义 = 安全、简洁、高性能三者兼顾

实用注意事项

用得顺手的前提是避开几个典型坑:

  • 别让它被隐式装箱 —— 传给 object 或非泛型集合(如 List)会失去值类型优势
  • 慎用可变字段混搭:比如 public record struct MixedPoint(int X, int Y) { public int Z { get; set; } },Z 可变但 X/Y 只读,容易引发逻辑混淆
  • 解构和模式匹配完全可用:var (x, y) = point;if (p is Point { X: > 0 })
  • SpanMemory 配合良好,特别适合底层数据处理层建模

基本上就这些。