一、先记住 4 条黄金规范（必须遵守）
- 两个对象 equals 为 true → hashCode 必须相同——这是铁律，违背了就直接出 Bug。
- hashCode 相同 → equals 不一定为 true（哈希冲突是允许的，但你要心里有数）。
- 参与
equals比较的属性，必须全部参与 hashCode 计算——少一个，去重就不可靠。 - 只要对象内容没变，
hashCode必须始终返回相同值——可变字段要小心，一旦变了就找不到了。
不遵守？HashSet/HashMap 就会把两个明明相等的对象当成不同元素，去重失败，内存里存一堆重复数据，排查起来非常痛苦。
二、最推荐写法（Objects 工具类，JDK 7+）
1. 通用模板（直接复制改属性名即可）
下面这个模板是业界最推荐的写法，用 JDK 7 引入的 Objects.equals 和 Objects.hash，简洁又安全。你只需要把类名和属性名改成自己的，剩下的交给编译器。
import ja va.util.Objects;
public class 类名 {
// 你的成员变量
private 类型 属性1;
private 类型 属性2;
// ======================== 重写开始 ========================
@Override
public boolean equals(Object o) {
// 1. 同一个对象，直接返回 true
if (this == o) return true;
// 2. 为null 或 类型不同，返回 false
if (o == null || getClass() != o.getClass()) return false;
// 3. 强制类型转换
类名 其他对象 = (类名) o;
// 4. 比较【所有关键业务属性】（决定是否重复的字段）
return Objects.equals(属性1, 其他对象.属性1)
&& Objects.equals(属性2, 其他对象.属性2);
}
@Override
public int hashCode() {
// 必须和 equals 里的属性完全一致！！！
return Objects.hash(属性1, 属性2);
}
// ======================== 重写结束 ========================
}
三、完整实战示例（最常用）
拿一个 User 对象来演示，根据 id + username 去重，age 字段不参与业务唯一性判断：
import ja va.util.Objects;
public class User {
private Long id;
private String username;
private Integer age; // 假设 age 不参与去重
// 构造、get、set 省略...
// ===================== 核心重写 =====================
@Override
public boolean equals(Object o) {
if (this == o) return true;
// 判断类型安全
if (o == null || getClass() != o.getClass()) return false;
User user = (User) o;
// 只比较【业务唯一】的字段：id + username
return Objects.equals(id, user.id)
&& Objects.equals(username, user.username);
}
@Override
public int hashCode() {
// 必须和 equals 完全一致！！！
return Objects.hash(id, username);
}
}
效果
new User(1, "张三", 20)new User(1, "张三", 30)
这两个对象虽然 age 不同，但 id 和 username 一样，放入 HashSet 后会被判定为重复元素，成功去重。这正是我们想要的效果。
四、为什么不能用 IDE 自动生成？（可以用，但要懂）
其实 IntelliJ IDEA 和 Eclipse 都能一键生成，完全可以用！
生成快捷键：
- Windows：Alt + Insert
- Mac：Cmd + N
选择 equals() and hashCode() → 勾选参与去重的字段 → 自动生成。生成的代码和上面给的模板完全一致，非常标准。所以不用纠结要不要自己手写，直接用 IDE 生成，但一定要搞懂背后的原理——否则哪天字段变了，你可能忘记同步更新两个方法。
五、最常见的 3 个错误（一定要避开）
错误 1：equals 和 hashCode 使用的属性不一致
// ❌ 错误示范 equals 用 id hashCode 用 username → 去重失效！
这是最隐蔽的错误，两个方法各自为政，导致 HashSet 在判断时 hashCode 不同直接跳过 equals，明明相等的对象插入了两次。
错误 2：只重写 equals，不重写 hashCode
// ❌ 致命错误 // HashSet 会先判断 hashCode，不同就直接插入，根本不会走 equals！
这个错误太经典了，很多人只记得重写 equals，却忘了 hashCode。结果 HashSet 永远无法去重，因为默认的 hashCode 是根据内存地址计算的，不同对象肯定不同。
错误 3：使用可变值参与 hashCode
比如用一个会被修改的字段（比如 name 后来被改了）来计算 hashCode。对象存入集合后，字段变了，hashCode 也变了，再想根据这个对象查找时，哈希表已经找不到原来的位置了。这会导致元素丢失、缓存失效等一系列诡异问题。
六、一句话总结（面试必背）
- equals 决定两个对象是否“内容相等”——业务上的相等。
- hashCode 决定对象在哈希表中的存储位置——查找效率的基石。
- HashSet 去重规则：hashCode 相同 + equals 为 true——两者缺一不可。
- 重写原则：参与 equals 的属性，必须全部参与 hashCode——保持一致，才能保证正确性。
