在C#中，GetHashCode和Equals是所有引用类型继承自Object类的两个重要方法，二者都和对象的相等性判定、哈希存储逻辑相关，很多场景下需要开发者根据业务需求自定义它们的实现逻辑。
GetHashCode方法是什么
GetHashCode方法的作用是返回当前对象的哈希码，这是一个32位的整数值。哈希码的核心用途是支持哈希类集合的高效存储和查找，比如Dictionary<TKey, TValue>、HashSet<T>等集合内部都会使用哈希码来组织数据。
Object类提供的默认GetHashCode实现，对于引用类型来说，通常会返回基于对象引用地址计算得到的哈希值，也就是说，两个内容相同但引用不同的对象，默认的GetHashCode返回值大概率不同。
Equals方法是什么
Equals方法用于判断两个对象是否相等，Object类的默认实现中，对于引用类型会直接比较两个对象的引用地址，只有两个变量指向同一个对象实例时才会返回true；对于值类型，默认实现会逐字段比较值是否相等。
如果我们需要自定义对象的相等逻辑，比如认为两个Person对象只要Id相同就属于相等对象，就需要重写Equals方法来实现自定义的判断规则。
为什么需要同时重写GetHashCode和Equals
很多开发者会疑惑，既然已经重写了Equals方法定义相等规则，为什么还要重写GetHashCode？这二者的关联在于哈希集合的工作逻辑：
- 当向哈希集合中添加元素时，集合会先调用对象的GetHashCode方法得到哈希值，确定元素存储的桶位置
- 当查找元素时，集合会先比较待查找对象的哈希值和桶中元素的哈希值，如果哈希值不同则直接判定不存在；如果哈希值相同，再调用Equals方法做最终的相等性判定
如果我们只重写了Equals而没有重写GetHashCode，就会出现两个对象被Equals判定为相等，但GetHashCode返回值不同的情况，这会导致哈希集合无法正确识别相等的对象，出现明明已经添加了对象却查找不到、或者同一个相等对象被重复添加的问题。
对应的规则是：如果两个对象调用Equals方法返回true，那么它们的GetHashCode返回值必须相同；反之，GetHashCode相同的两个对象，Equals不一定返回true（这种情况称为哈希冲突，是允许的，冲突后靠Equals做最终判定）。
正确的重写示例
下面以Person类为例，演示同时重写Equals和GetHashCode的规范写法：
public class Person
{
public int Id { get; set; }
public string Name { get; set; }
// 重写Equals方法，定义相等规则：Id相同的Person对象视为相等
public override bool Equals(object obj)
{
// 判断是否为null
if (obj == null)
{
return false;
}
// 判断是否为同一类型
if (obj.GetType() != this.GetType())
{
return false;
}
Person other = (Person)obj;
// 比较Id字段
return this.Id == other.Id;
}
// 重写GetHashCode，保证Equals相等的对象哈希值相同
public override int GetHashCode()
{
// 返回Id的哈希值，因为Id是相等判断的依据
return Id.GetHashCode();
}
}
如果类中还有其他的字段参与相等性判断，那么GetHashCode的计算也需要把这些字段考虑进去，比如如果Name也参与相等判定，那么GetHashCode可以这样实现：
public override int GetHashCode()
{
unchecked
{
int hash = 17;
// 结合Id和Name的哈希值计算最终哈希
hash = hash * 23 + Id.GetHashCode();
hash = hash * 23 + (Name == null ? 0 : Name.GetHashCode());
return hash;
}
}
这里使用unchecked块是为了避免哈希计算过程中出现整数溢出报错，溢出在哈希计算中是可以接受的。
注意事项
- GetHashCode返回值必须是稳定的，也就是说，对象参与哈希计算的字段如果没有发生变化，那么GetHashCode的返回值不能改变。如果对象是可变的，且参与哈希计算的字段会被修改，那么不要把这个对象作为哈希集合的键使用，否则会导致集合行为异常
- 不要在GetHashCode中抛出异常，哈希集合调用该方法时不会处理异常，会直接导致程序崩溃
- 重写Equals方法时，建议同时实现IEquatable<T>接口，这样可以避免值类型的装箱操作，提升性能，比如上面的Person类可以实现IEquatable<Person>接口，在接口方法中定义类型安全的相等判断逻辑
总结来说，只要重写了Equals方法自定义了对象的相等逻辑，就必须同时重写GetHashCode，保证相等对象的哈希值一致，这样才能让哈希类集合正常工作，避免出现难以排查的逻辑错误。
GetHashCodeEqualsC#_重写哈希表修改时间：2026-07-04 07:06:25