必须同时重写equals和hashcode方法，因为hashset基于hashmap实现，先用hashcode定位桶再用equals确认相等；若二者不一致，会导致重复插入或查找不到。
要让 HashSet 正确识别自定义对象是否重复，必须同时重写 equals 和 hashCode 方法，并保证二者逻辑一致。否则，对象可能在集合中“明明相等却查不到”，或“看似不同却被当作重复丢弃”。
为什么必须同时重写 equals 和 hashCode
HashSet 底层基于 HashMap 实现，添加元素时：
- 先用
hashCode()计算哈希值，决定存入哪个桶（bucket）； - 再在该桶内调用
equals()逐个比较，确认是否已存在相同对象。
如果只重写 equals 而不重写 hashCode，两个逻辑上相等的对象可能因默认 hashCode（基于内存地址）不同，被分到不同桶里，HashSet 就永远无法发现它们相等——导致重复插入；反之，若只重写 hashCode 而 equals 仍用默认实现（即引用比较），即使哈希值相同，equals 仍返回 false，也会误判为不重复。
重写规则：一致性与对称性
核心原则是：如果两个对象 equals 返回 true，它们的 hashCode 必须相同；反之不强制，但相同 hashCode 的对象应尽量 equals 为 true（提高查找效率）。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
常见安全做法：
- 只用“参与
equals比较”的字段来计算hashCode； - 避免使用可变字段（如后期会修改的属性），否则对象加入
HashSet后若修改了这些字段，哈希值改变，就再也找不到了； - 推荐用
Objects.equals()和Objects.hash()，它们自动处理null安全问题。
一个典型示例：Person 类
假设按姓名和年龄判断是否为同一人：
<font size="2"><pre class="brush:php;toolbar:false;">public class Person {
private String name;
private int age;
public Person(String name, int age) {
this.name = name;
this.age = age;
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
Person person = (Person) o;
return age == person.age && Objects.equals(name, person.name);
}
@Override
public int hashCode() {
return Objects.hash(name, age); // 顺序和 equals 中字段顺序一致
}
}
这样写后：
-
new HashSet<person>().add(new Person("Alice", 25))</person>和再次添加new Person("Alice", 25)，只会保留一个； -
set.contains(new Person("Alice", 25))会正确返回true； - 若把
name改成null，Objects.equals和Objects.hash也不会抛NullPointerException。
验证是否生效的小技巧
写完重写方法后，建议快速验证：
- 创建两个字段完全相同的对象
p1和p2，检查p1.equals(p2)和p1.hashCode() == p2.hashCode()是否都为true； - 往
HashSet里连续 add 这两个对象，打印size()看是否为 1； - 修改其中一个对象的
name或age（如果字段不是final），再contains原对象——此时结果不可靠，说明不该用可变字段参与equals/hashCode。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
