自定义对象放入HashSet等哈希集合必须重写equals()和hashCode()以保证一致性,否则导致重复、查找失败;放入TreeSet需实现Comparable或传Comparator;序列化要求类实现Serializable且成员可序列化。

Java 集合能直接存储自定义对象,但必须确保该类满足基本契约——尤其是 equals() 和 hashCode() 的一致性,否则在 HashSet、HashMap 等基于哈希的集合中会出现重复添加、查不到、删除失败等问题。
为什么自定义对象放进 ArrayList 没问题,放进 HashSet 就乱了
因为 ArrayList 仅依赖引用或显式比较(如 contains() 调用 equals()),而 HashSet 内部用 HashMap 实现,先靠 hashCode() 定位桶,再用 equals() 判等。若没重写这两个方法,所有实例默认继承自 Object,hashCode() 返回内存地址,equals() 比较引用——导致逻辑上相等的对象被当成不同元素。
实操建议:
- 所有要放入
HashSet、HashMap键、LinkedHashSet的自定义类,必须重写equals(Object)和hashCode() - IDE(如 IntelliJ)可自动生成:右键 →
Generate→ 选字段 → 勾选use getters(如果用了封装) - 若字段含可变对象(如
ArrayList、自定义可变类),需确保其自身也正确实现了hashCode()/equals()
TreeSet 存自定义对象必须实现 Comparable 或传 Comparator
TreeSet 不依赖哈希,而是红黑树排序,因此要求元素可比较。否则运行时抛出 ClassCastException: YourClass cannot be cast to java.lang.Comparable。
立即学习“Java免费学习笔记(深入)”;
两种合法方式:
- 让类实现
Comparable,重写compareTo()方法(推荐用于自然顺序) - 构造
TreeSet时传入Comparator实例,例如:new TreeSet
((a, b) -> a.getName().compareTo(b.getName())); - 注意:若用
Comparator,且对象字段后续修改影响比较结果(如name被改),会导致树结构损坏,无法查找——TreeSet 中的对象应视为不可变,或至少参与比较的字段不可变
序列化与集合中自定义对象的注意事项
若集合要写入文件或网络传输(如用 ObjectOutputStream),其中每个自定义对象类必须实现 Serializable 接口,且所有非 transient 成员变量类型也得可序列化。
常见陷阱:
- 忘记加
serialVersionUID字段,导致类结构微调后反序列化失败(报InvalidClassException) - 成员含
Thread、Socket、InputStream等不可序列化类型,又没标transient -
ArrayList可序列化,但前提是Person类本身满足序列化要求
真正容易被忽略的是:即使你只用 ArrayList,只要未来可能转成 HashSet、做 JSON 序列化(如 Jackson)、或进缓存(如 RedisTemplate),equals()/hashCode() 就不是“可有可无”,而是设计阶段就该定下的契约。










