Java自定义类“完美”复写equals、hashCode、toString需遵循契约：equals须满足五条黄金契约并用Objects.equals处理null；hashCode必须与equals字段一致且避免可变字段；toString应清晰可读、脱敏敏感信息、不触发副作用。
在 Java 中，自定义类要“完美”复写 Object 的核心方法（equals、hashCode、toString），关键不是机械重写，而是遵循契约、保持一致性、兼顾可读性与健壮性。下面分三块讲清楚怎么做才靠谱。
equals 方法：遵守五条黄金契约
equals 不是随便比字段，必须满足自反性、对称性、传递性、一致性、非空性。常见错误是只判 null 或漏掉类型检查。
- 先用
==判断引用相等（性能优化） - 再用
instanceof或getClass() == obj.getClass()做类型安全检查（推荐后者，避免子类破坏对称性） - 强制转换后，逐个比较所有参与逻辑相等的字段（注意 null 安全：用
Objects.equals(a, b)） - 不要比较无关字段（如数据库 ID、缓存标记），否则可能违反业务语义
hashCode 方法：必须与 equals 严格同步
只要两个对象 equals 返回 true，它们的 hashCode 就必须相同；反之不成立。最稳妥方式是用 Objects.hash(...)。
- 传入的字段必须和
equals中用于判断相等的字段完全一致 - 避免使用可变字段（如后续会修改的 List、Date），否则放入 HashSet/HashMap 后可能找不到
- 如果类不可变，可以懒缓存 hash 值（首次计算后保存，提升性能）
- 不要返回固定值（如
return 1;），那会让哈希表退化成链表
toString 方法：清晰、可读、无副作用
它不是 debug 工具，而是面向开发者的信息快照。重点是结构清晰、字段有意义、不抛异常、不触发复杂计算。
立即学习“Java免费学习笔记（深入）”；
- 格式建议用
ClassName[field1=value1, field2=value2]（IDEA 和 Lombok 默认风格） - 敏感字段（如密码、token）要脱敏或省略，避免日志泄露
- 避免调用可能抛异常或阻塞的方法（比如远程调用、文件读取）
- 大集合建议截断显示（如
items.size()=123而非全部打印），防止日志爆炸
不复杂但容易忽略：三个方法必须一起改，改一个不改另一个就会埋坑。用 IDE 自动生成（Alt+Insert / Cmd+N）是起点，但得人工核对字段是否合理、是否遗漏 null 处理、是否包含不该参与比较的字段。真正“完美”的复写，本质是让对象的行为符合直觉，而不是代码行数多寡。
