Java 必看：如何正确重写 hashCode() 和 equals() 方法？

@[TOC]( Java 必看：如何正确重写 hashCode() 和 equals() 方法？)

一、先记住 4 条黄金规范（必须遵守）

1. 两个对象 equals 为 true → hashCode 必须相同
2. hashCode 相同 → equals 不一定为 true（哈希冲突）
3. 参与equals比较的属性，必须全部参与 hashCode 计算
4. 只要对象内容没变，hashCode必须始终返回相同值

不遵守 → HashSet/HashMap 无法去重，出现严重 Bug！

二、最推荐写法（Objects 工具类，JDK 7+）

1. 通用模板（直接复制改属性名即可）

importjava.util.Objects;publicclass类名{// 你的成员变量private类型 属性1;private类型 属性2;// ======================== 重写开始 ========================@Overridepublicbooleanequals(Objecto){// 1. 同一个对象，直接返回 trueif(this==o)returntrue;// 2. 为null 或 类型不同，返回 falseif(o==null||getClass()!=o.getClass())returnfalse;// 3. 强制类型转换类名 其他对象=(类名)o;// 4. 比较【所有关键业务属性】（决定是否重复的字段）returnObjects.equals(属性1,其他对象.属性1)&&Objects.equals(属性2,其他对象.属性2);}@OverridepublicinthashCode(){// 必须和 equals 里的属性完全一致！！！returnObjects.hash(属性1,属性2);}// ======================== 重写结束 ========================}

三、完整实战示例（最常用）

以User对象为例，根据id + username去重：

importjava.util.Objects;publicclassUser{privateLongid;privateStringusername;privateIntegerage;// 假设 age 不参与去重// 构造、get、set 省略...// ===================== 核心重写 =====================@Overridepublicbooleanequals(Objecto){if(this==o)returntrue;// 判断类型安全if(o==null||getClass()!=o.getClass())returnfalse;Useruser=(User)o;// 只比较【业务唯一】的字段：id + usernamereturnObjects.equals(id,user.id)&&Objects.equals(username,user.username);}@OverridepublicinthashCode(){// 必须和 equals 完全一致！！！returnObjects.hash(id,username);}}

效果

• new User(1, "张三", 20)
• new User(1, "张三", 30)

放入 HashSet 会被判定为重复元素，成功去重！

四、为什么不能用 IDE 自动生成？（可以用，但要懂）

IntelliJ IDEA / Eclipse 都能一键生成，完全可以用！

生成快捷键：

• Windows：Alt + Insert
• Mac：Cmd + N

选择：equals() and hashCode()→ 勾选参与去重的字段 → 自动生成！

生成的代码和我上面给的完全一致，非常标准。

五、最常见的 3 个错误（一定要避开）

错误 1：equals 和 hashCode 使用的属性不一致

// ❌ 错误示范equals 用 id hashCode 用 username → 去重失效！

错误 2：只重写 equals，不重写 hashCode

// ❌ 致命错误// HashSet 会先判断 hashCode，不同就直接插入，根本不会走 equals！

错误 3：使用可变值参与 hashCode

比如用一个会被修改的变量计算 hashCode
→ 对象存入后值变了 → hashCode 变了 → 再也找不到这个元素！

六、一句话总结（面试必背）

1. equals 决定两个对象是否“内容相等”
2. hashCode 决定对象在哈希表中的存储位置
3. HashSet 去重规则：hashCode 相同 + equals 为 true
4. 重写原则：参与 equals 的属性，必须全部参与 hashCode