Record 是 C# 9.0 引入的引用类型,用于简洁表示不可变数据模型,自动提供值相等性、ToString() 格式化和 with 表达式复制,适用于 DTO、事件建模等场景。

Record 是 C# 9.0 引入的一种引用类型,专门用于表示不可变的数据模型。它简化了定义“数据承载类”的语法,并自动提供值语义的相等性判断、复制和格式化功能。与普通 class 不同,record 更强调“这个对象包含什么数据”,而不是“它能做什么行为”。
Record 的核心特性
定义一个 record 非常简单:
public record Person(string FirstName, string LastName, int Age);上面这行代码相当于自动生成了:
- 一个带有三个参数的构造函数
- 三个只读属性(通过参数初始化)
- 重写的 Equals()、GetHashCode() 方法,基于所有属性的值进行比较
- ToString() 方法会输出类似 Person { FirstName = John, LastName = Doe, Age = 30 } 的格式
- 支持 with 表达式实现非破坏性修改
例如:
var p1 = new Person("Alice", "Smith", 25);var p2 = new Person("Alice", "Smith", 25);
Console.WriteLine(p1 == p2); // 输出 True,因为值相等
使用 with 表达式创建副本
由于 record 是不可变的,要“修改”某个字段,实际上是创建一个新实例:
var p3 = p1 with { Age = 26 };Console.WriteLine(p3); // Person { FirstName = Alice, LastName = Smith, Age = 26 }
原始的 p1 不受影响,这种模式在函数式编程中非常有用。
可变 record 属性(可选)
虽然推荐不可变性,但你也可以定义可变属性:
{
public string FirstName { get; init; } // init-only setter
public string LastName { get; init; }
public int Age { get; set; } // 普通 setter,允许后续修改
}
init 访问器允许在对象初始化时赋值,之后不能再修改,有助于保持构造阶段的灵活性和运行时的不可变性。
适合使用 Record 的场景
Record 特别适用于以下情况:
- 数据传输对象(DTO):在 API 接口之间传递数据,关注的是结构和内容,而非行为
- 消息或事件建模:如订单创建、用户注册等事件,天然具备不可变特征
- 配置或设置类:希望配置一旦建立就不被随意更改
- 函数式编程风格:配合 with 表达式实现状态转换而不改变原对象
- 单元测试中的测试数据构建:清晰、简洁地表达预期数据结构
比如在 ASP.NET Core 中返回 API 响应:
public record ApiResponse(bool Success, string Message, object Data);这种写法比传统 class 更轻量,语义更明确。
基本上就这些。record 不是用来替代 class 的,而是为特定数据建模需求提供更优雅的语法支持。当你发现某个类主要用来存储数据、需要比较内容相等性、且倾向于不可变时,就可以考虑用 record。不复杂但容易忽略。









