C# IEqualityComparer接口的用法 - 自定义字典的键比较逻辑

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

IEqualityComparer 接口用于告诉 .NET 容器（比如

Dictionary<k></k>

、

HashSet<t></t>

）如何比较两个键是否“相等”，以及如何为键生成哈希码。默认情况下，字典用引用或值类型的默认相等逻辑，但很多时候你需要按自定义规则判断——比如忽略大小写、按部分字段比较、或处理 null 安全等。

什么时候必须实现 IEqualityComparer

当你把自定义类（非 string 或基本类型）作为字典的键，并且不希望用默认的引用相等（或字段全等）时，就需要提供自己的比较逻辑。常见场景包括：

用
Person
对象作键，只按
Id
判断是否相同，忽略姓名变化用字符串作键，但要求不区分大小写（
StringComparer.OrdinalIgnoreCase
就是现成实现）键可能为
null
，而默认比较会抛异常，需安全处理 需要按业务含义合并键，比如 “user_123” 和 “123” 视为同一键

如何实现一个简单的 IEqualityComparer

以

Product

类为例，我们希望字典只根据

SKU

字段判断键是否相等：

public class Product
{
    public string SKU { get; set; }
    public string Name { get; set; }
}
<p>public class ProductBySkuComparer : IEqualityComparer<Product>
{
public bool Equals(Product x, Product y)
{
if (x == null && y == null) return true;
if (x == null || y == null) return false;
return string.Equals(x.SKU, y.SKU, StringComparison.OrdinalIgnoreCase);
}</p><pre class="brush:php;toolbar:false;">public int GetHashCode(Product obj)
{
    if (obj == null) return 0;
    return StringComparer.OrdinalIgnoreCase.GetHashCode(obj.SKU);
}

}

注意两点：

Equals
必须满足自反性、对称性、传递性、一致性，且对 null 要有明确处理
GetHashCode
返回值必须和
Equals
逻辑一致：如果两个对象
Equals
返回
true
，它们的哈希码必须相同

在字典中使用自定义比较器

创建字典时传入比较器实例即可：

var dict = new Dictionary<Product, decimal>(new ProductBySkuComparer());
dict[new Product { SKU = "ABC-001", Name = "Laptop" }] = 999.99m;
dict[new Product { SKU = "abc-001", Name = "Notebook" }] = 899.99m; // 覆盖上一条
<p>Console.WriteLine(dict.Count); // 输出 1</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1915" title="Summarizer"><img
                                                                                src="https://www.herecours.com/d/file/efpub/2026/21-21/20260221140131179495.jpg" alt="Summarizer"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1915" title="Summarizer">Summarizer</a>
                                                                        <p>基于 AI 的文本段落摘要生成器</p>
                                                                </div>
                                                                <a href="/ai/1915" title="Summarizer" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div>

也可以用静态工厂方法简化，比如针对字符串：

var caseInsensitiveDict = new Dictionary<string, int>(StringComparer.OrdinalIgnoreCase);

更灵活的方式：用 Lambda 表达式（C# 7.3+）

如果你不想写完整类，可以用

EqualityComparer<t>.Create</t>

配合委托：

var productComparer = EqualityComparer<Product>.Create(
    (x, y) => string.Equals(x?.SKU, y?.SKU, StringComparison.OrdinalIgnoreCase),
    x => x == null ? 0 : StringComparer.OrdinalIgnoreCase.GetHashCode(x.SKU)
);
<p>var dict = new Dictionary<Product, decimal>(productComparer);</p>

这种方式适合一次性、轻量级的比较逻辑，代码更紧凑，也避免了额外类型声明。

基本上就这些。核心是：只要键的“相等”含义和默认不一样，就得管好