如何使用Equals方法实现KeyValuePair的键与值按值比较？

首先，咱们先搞清楚KeyValuePair<TKey, TValue>默认的Equals逻辑：它会分别调用键的Equals方法和值的Equals方法，只有两者都返回true时，整个KeyValuePair才被认为相等。这就是你看到不同结果的原因——如果键是值类型（比如int、struct），默认就是按值比较；但如果值是引用类型（比如自定义类），默认的Equals是引用比较（判断是否是同一个对象实例），除非这个引用类型自己重写了Equals方法。

要实现键和值都按自定义值比较，分两种场景来处理：

场景1：你能控制键/值类型的定义 #

如果键或值是你自己编写的类型（不管是struct还是class），直接在类型内部重写Equals和GetHashCode方法，实现你想要的值比较逻辑即可。这样KeyValuePair的默认Equals会自动复用这些自定义逻辑。

举个例子，假设我们有一个自定义的User类，希望按Id和Name来判断对象相等：

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }

    // 重写Equals实现值比较
    public override bool Equals(object obj)
    {
        if (obj is not User other)
            return false;
        return Id == other.Id && Name == other.Name;
    }

    // 必须同时重写GetHashCode，保证相等的对象哈希码一致
    public override int GetHashCode()
    {
        return HashCode.Combine(Id, Name);
    }
}

现在用KeyValuePair<int, User>来比较，就会按自定义逻辑判断相等：

var pair1 = new KeyValuePair<int, User>(1, new User { Id = 1, Name = "Alice" });
var pair2 = new KeyValuePair<int, User>(1, new User { Id = 1, Name = "Alice" });

Console.WriteLine(pair1.Equals(pair2)); // 输出True

场景2：无法修改目标类型（比如第三方类） #

如果键或值是第三方库的类型，你没法修改它的Equals方法，那可以自定义一个IEqualityComparer<KeyValuePair<TKey, TValue>>，在这个比较器里实现你想要的键和值的自定义比较逻辑，然后在需要比较的时候使用这个比较器，而不是依赖KeyValuePair的默认Equals。

比如假设我们有一个第三方的Product类，它默认是引用比较，但我们想按ProductId来判断相等，那可以写这样的比较器：

public class CustomKeyValuePairComparer<TKey, TValue> : IEqualityComparer<KeyValuePair<TKey, TValue>>
{
    private readonly IEqualityComparer<TKey> _keyComparer;
    private readonly IEqualityComparer<TValue> _valueComparer;

    // 允许传入键和值的自定义比较器，灵活控制逻辑
    public CustomKeyValuePairComparer(IEqualityComparer<TKey> keyComparer = null, IEqualityComparer<TValue> valueComparer = null)
    {
        _keyComparer = keyComparer ?? EqualityComparer<TKey>.Default;
        _valueComparer = valueComparer ?? EqualityComparer<TValue>.Default;
    }

    public bool Equals(KeyValuePair<TKey, TValue> x, KeyValuePair<TKey, TValue> y)
    {
        // 自定义键和值的比较逻辑
        return _keyComparer.Equals(x.Key, y.Key) && _valueComparer.Equals(x.Value, y.Value);
    }

    public int GetHashCode(KeyValuePair<TKey, TValue> obj)
    {
        return HashCode.Combine(_keyComparer.GetHashCode(obj.Key), _valueComparer.GetHashCode(obj.Value));
    }
}

然后针对Product类，写一个按ProductId比较的子比较器：

public class ProductByIdComparer : IEqualityComparer<Product>
{
    public bool Equals(Product x, Product y)
    {
        if (x == null || y == null)
            return x == y;
        return x.ProductId == y.ProductId;
    }

    public int GetHashCode(Product obj)
    {
        return obj?.ProductId.GetHashCode() ?? 0;
    }
}

最后用自定义比较器判断KeyValuePair是否相等：

var pair1 = new KeyValuePair<string, Product>("A", new Product { ProductId = 100, Name = "Laptop" });
var pair2 = new KeyValuePair<string, Product>("A", new Product { ProductId = 100, Name = "Notebook" });

var comparer = new CustomKeyValuePairComparer<string, Product>(null, new ProductByIdComparer());
Console.WriteLine(comparer.Equals(pair1, pair2)); // 输出True，因为ProductId相同

补充说明 #

• 不管哪种方式，都要记得同时重写/实现GetHashCode，否则如果把KeyValuePair放到哈希集合（比如HashSet<KeyValuePair<,>>、Dictionary<KeyValuePair<,>, ...>）里，会出现无法正确查找、重复元素的问题。
• 对于值类型，默认的Equals就是按值比较，但如果你想自定义值类型的比较逻辑，同样可以重写Equals和GetHashCode。

内容的提问来源于stack exchange，提问作者Michael Haddad