要让自定义对象在HashMap、HashSet中作为高性能唯一标识键，核心是equals与hashCode协同工作：前者定义相等性，后者确保相等对象定位到同一桶；设计需满足一致性、不变性、分布均匀性，且必须基于不可变业务字段（如ID、SKU），避免可变引用或未就绪字段参与哈希计算。
要让自定义对象在 HashMap、HashSet 等集合中作为高性能唯一标识键，核心不是“追求哈希值绝对不重复”，而是让 equals 和 hashCode 协同工作：前者定义“什么算相等”，后者确保相等对象能被快速定位到同一桶中。设计的关键在于**一致性 + 不变性 + 分布均匀性**。
用不可变字段做唯一依据
唯一标识键必须基于业务上稳定、不变的字段。例如用户 ID、订单编号、SKU 编码等。一旦对象加入哈希集合，这些字段就不能再修改——否则哈希桶位置与当前值不匹配，对象将无法被 contains 或 remove 找到。
- 避免使用可变引用（如
ArrayList、StringBuilder），它们内容变化会导致哈希值失效 - 时间戳、随机数、计算缓存字段（如
cachedHash）不能参与hashCode - 数据库自增 ID 若在对象构造后才赋值，需确保插入集合前已就位；否则两个“半成品”对象可能因 ID 为 0 而误判相等
equals 实现要安全且高效
equals 是最终拍板“是否唯一”的逻辑开关，必须满足五项契约，同时兼顾性能：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 先做引用比较：
if (this == obj) return true;，快速拦截同一实例 - 再判空和类型：
if (!(obj instanceof YourKey)) return false;，避免强转异常 - 字段比较统一用
Objects.equals(a, b)，它自动处理null，比a != null && a.equals(b)更简洁可靠 - 优先比较开销小、区分度高的字段（如 ID 是 long 类型，比 String name 更快；若 ID 已不同，name 就不用比了）
hashCode 必须与 equals 完全对齐
hashCode 不是独立存在的，它只是 equals 的“索引加速器”。只要 equals 里用了某个字段，hashCode 就必须包含它，顺序也建议一致（便于人工核对）：
立即学习“Java免费学习笔记（深入）”；
- 首选
Objects.hash(id, code, type)—— 内部用质数运算，null 安全，分布合理，无需手写31 * x + y - 数组字段必须用
Arrays.hashCode(arr)，不能直接调arr.hashCode()（那是引用哈希） - 浮点字段慎用
Double.doubleToLongBits()处理 NaN，避免两个 NaN 值被当成不同 - 绝对不要返回常量（如
return 1;），否则所有对象挤进一个桶，查找退化为 O(n)
借助工具生成并验证
手动编写易漏字段或破坏一致性。推荐组合使用：
- IDEA：右键 → Generate → equals() and hashCode()，勾选全部关键字段，生成即用
- Lombok：
@EqualsAndHashCode(onlyExplicitlyIncluded = true)+ 在字段上加@EqualsAndHashCode.Include，显式控制范围 - 单元测试必加：验证自反性、对称性、传递性、null 安全，以及
equal(a,b) == true ⇒ a.hashCode() == b.hashCode()
