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

来源：这里教程网时间：2026-02-21 17:32:35 作者：

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<object></object>
）会失去值类型优势慎用可变字段混搭：比如
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 })
和
Span<t></t>
、
Memory<t></t>
配合良好，特别适合底层数据处理层建模