首页 > 文章 > java教程

Java对象equals与hashCode详解

时间：2025-10-21 17:07:49 393浏览收藏

**Java对象equals与hashCode深度解析：正确重写的重要性** 在Java编程中，`equals`和`hashCode`是`Object`类中至关重要的两个方法，尤其是在使用`HashMap`、`HashSet`等集合时。本文深入探讨了`equals`和`hashCode`之间的契约关系：若两个对象通过`equals`方法比较相等，则它们的`hashCode`值必须相等。因此，在重写`equals`方法时，务必同时重写`hashCode`方法，以确保对象在哈希集合中能正确存储和检索。文章通过实例详细讲解了只重写`equals`而不重写`hashCode`可能导致的问题，并提供了正确重写的建议，帮助开发者编写更健壮、高效的Java代码，避免潜在的bug。理解并遵循这一原则，是编写高质量Java类的关键。

若两个对象equals为true，则它们的hashCode必须相等；因此在重写equals时必须同时重写hashCode，以确保对象在HashMap、HashSet等集合中能正确工作。

Java中对象的equals与hashCode关系

在Java中，equals 和 hashCode 是两个定义在 Object 类中的方法，它们共同影响对象在集合（尤其是 HashMap、HashSet 等哈希结构）中的行为。正确理解并合理重写这两个方法的关系，对程序的正确性和性能至关重要。

equals 与 hashCode 的契约关系

Java官方明确规定：如果两个对象通过 equals 方法比较返回 true，那么它们的 hashCode 必须相等。反之则不一定成立 —— 即 hashCode 相同，equals 不一定为 true（这就是哈希冲突）。

这个规则出自《Effective Java》，是编写高质量Java类的基础之一。

具体来说，必须遵守以下原则：

若 a.equals(b) == true，则 a.hashCode() == b.hashCode()
若 a.hashCode() != b.hashCode()，则 a.equals(b) 一定为 false
若 a.hashCode() == b.hashCode()，a.equals(b) 可能为 true，也可能为 false

为什么需要同时重写 equals 和 hashCode？

当你使用 HashMap 或 HashSet 存储自定义对象时，系统会先通过 hashCode 找到对应的桶位置，再用 equals 判断是否为同一对象。

如果你只重写了 equals 而没有重写 hashCode，会导致：

逻辑上“相等”的对象（equals 返回 true）可能拥有不同的哈希值
这些对象会被存入不同的桶中，导致无法通过 get 或 contains 正确查找到
例如：把一个 Person 对象作为 key 放入 HashMap，之后用另一个“相同内容”的 Person 去 get，结果返回 null

实际示例说明

假设有一个 Person 类：

public class Person {
    private String name;
    private int age;

    // 只重写了 equals，未重写 hashCode
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (!(o instanceof Person)) return false;
        Person person = (Person) o;
        return age == person.age && Objects.equals(name, person.name);
    }
}

此时虽然两个 name 和 age 相同的 Person 被认为相等，但由于继承自 Object 的 hashCode 是基于内存地址生成的，不同实例的哈希值不同。

执行以下代码可能出现问题：

Map map = new HashMap();
Person p1 = new Person("Alice", 25);
Person p2 = new Person("Alice", 25);
System.out.println(p1.equals(p2)); // true
map.put(p1, "value");
System.out.println(map.get(p2)); // null（期望是"value"）

原因就是 p1 和 p2 的 hashCode 不同，get 时找不到对应桶。

如何正确重写

建议使用 IDE 自动生成或借助工具类（如 Objects.hash）来保持一致性。

@Override
public int hashCode() {
return Objects.hash(name, age);
}

这样，只要 name 和 age 相同，hashCode 就相同，满足了与 equals 的契约。

基本上就这些。只要记住：用了 equals 判断业务上的“相等”，就一定要让 hashCode 反映同样的逻辑，尤其是在要把对象放进哈希集合的时候。

终于介绍完啦！小伙伴们，这篇关于《Java对象equals与hashCode详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！

equals 重写 hashCode 哈希集合契约关系