当自定义类作字典键且需非默认相等逻辑时必须实现 IEqualityComparer，例如按特定字段（如 SKU）比较、忽略大小写或处理 null；实现时需确保 Equals 满足相等性规则，并使 GetHashCode 与之同步，避免哈希冲突；可通过实现接口、使用 StringComparer 或 Lambda 创建轻量比较器，在字典构造时传入即可生效。
IEqualityComparerDictionary<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也可以用静态工厂方法简化，比如针对字符串：
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);这种方式适合一次性、轻量级的比较逻辑，代码更紧凑，也避免了额外类型声明。
基本上就这些。核心是：只要键的“相等”含义和默认不一样，就得管好 Equals 和 GetHashCode 的配合。写对了，字典就能按你预期工作；写错了，可能查不到、重复插入、甚至哈希桶错乱。
