C# 9.0 Record避坑指南：为什么我的Equals比较总出错？

最新推荐文章于 2026-06-22 09:12:58 发布

原创

最新推荐文章于 2026-06-22 09:12:58 发布 · 26 阅读

标签

#C# #Record #值相等性 #集合操作

C# 9.0 Record避坑指南：为什么我的Equals比较总出错？

最近在重构一个老项目时，我打算用C# 9.0引入的record类型来简化一些数据传输对象。本以为这会是一次优雅的升级，没想到却接连踩了几个大坑。最让我头疼的是，明明两个record实例看起来一模一样，但HashSet去重就是失效，Dictionary查找也总是返回null。如果你也遇到过类似“为什么我的Equals比较总出错”的困惑，那么这篇文章正是为你准备的。我们将深入record类型值相等性的核心机制，剖析那些看似诡异的行为背后隐藏的细节，并给出切实可行的诊断步骤和解决方案。无论你是刚开始接触record的开发者，还是已经用它写过不少代码但偶尔会感到困惑的老手，相信都能从中获得启发。

1. 理解Record的“值相等性”：不只是语法糖

很多开发者初次接触record时，会把它看作一种“语法糖”——一种更简洁的定义不可变数据类的方式。这种理解没错，但过于简化，尤其是当我们讨论相等性比较时。record的相等性行为，是其区别于class最核心、也最容易引发问题的特性之一。

在C#中，引用类型（class）的默认相等性比较是基于引用相等的。也就是说，object.Equals方法默认比较两个变量是否指向堆中的同一个对象。而record类型，虽然也是引用类型，但其设计初衷是代表一组数据，因此编译器为其自动生成了基于值相等的Equals方法、GetHashCode方法以及==/!=运算符的重载。

注意：record的“值相等性”比较的是所有公共属性和字段的值，而不是内存地址。这是理解后续所有问题的基石。

让我们看一个简单的例子，感受一下这种差异：

// 使用 class
public class PersonClass
{
    public string Name { get; init; }
    public int Age { get; init; }
}

// 使用 record
public record PersonRecord(string Name, int Age);

class Program
{
    static void Main()
    {
        var personClass1 = new PersonClass { Name = "Alice", Age = 30 };
        var personClass2 = new PersonClass { Name = "Alice", Age = 30 };

        var personRecord1 = new PersonRecord("Alice", 30);
        var personRecord2 = new PersonRecord("Alice", 30);

        Console.WriteLine($"Class Equals: {personClass1.Equals(personClass2)}"); // 输出: False
        Console.WriteLine($"Record Equals: {personRecord1.Equals(personRecord2)}"); // 输出: True

        Console.WriteLine($"Class == : {personClass1 == personClass2}"); // 输出: False (除非重载==)
        Console.WriteLine($"Record == : {personRecord1 == personRecord2}"); // 输出: True
    }
}

这个例子清晰地展示了区别。对于class，即使所有属性值相同，它们也是两个不同的对象。而对于record，只要所有成员的值相等，它们就被认为是相等的。这种特性在需要将数据作为值来处理的场景下非常有用，比如作为字典的键、在集合中进行去重，或者进行快照比较。

然而，正是这种自动生成的、基于所有成员的相等性逻辑，在某些复杂情况下会变得“不透明”，导致开发者预期之外的行为。接下来，我们将深入几个最常见的“坑”。

2. 集合去重失败：当HashCode与Equals步调不一致

这是我遇到的第一个坑。我创建了一个HashSet<MyRecord>，往里添加了几个“值相同”的记录实例，期望集合能自动去重，结果却发现集合的大小超出了预期。

public record Product(string Id, string Name, decimal Price);

var productSet = new HashSet<Product>();
productSet.Add(new Product("P001", "Laptop", 999.99m));
productSet.Add(new Product("P001", "Laptop", 999.99m));

Console.WriteLine($"HashSet Count: {productSet.Count}"); // 你期望是1，但输出可能是2！

如果出现了上述情况，问题很可能出在可变字段或引用类型成员上。record自动生成的GetHashCode()方法会计算所有声明的主构造函数参数（对于record class）或所有公共属性/字段（对于record struct）的哈希值。如果这些成员中包含了可变字段，或者包含了引用类型且该引用类型没有正确实现值语义，就会导致问题。