Java 中默认 equals() 仅比较对象引用是否相同；若需按字段值判断两个对象是否“内容相等”，必须重写 equals() 和 hashCode() 方法，并确保二者语义一致。
java 中默认 `equals()` 仅比较对象引用是否相同；若需按字段值判断两个对象是否“内容相等”，必须重写 `equals()` 和 `hashcode()` 方法，并确保二者语义一致。
在实际开发中，我们常误以为 obj1.equals(obj2) 会自动对比对象内部所有字段的值——但事实并非如此。Object.equals() 的默认实现等价于 ==，即仅当两个变量指向同一内存地址时才返回 true。因此，即使两个 StateMachine 实例包含完全相同的 lamps 映射（键值对、LED 状态全一致），只要它们是不同 new 出来的对象，equals() 就返回 false。
要实现基于业务逻辑的相等性判断，必须显式重写 equals() 方法。以 StateMachine 类为例，其核心状态由 Map<integer led></integer> 承载，因此相等性应取决于该映射的内容是否一致。同时，根据 Java 规范，只要重写了 equals()，就必须重写 hashCode()，否则将破坏哈希集合（如 HashSet、HashMap 的 key）的正确行为——因为 equals() 为 true 的对象必须具有相同的 hashCode() 值。
以下是推荐的实现方式（使用现代 Java 最佳实践）：
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
public class StateMachine {
private final Map<Integer, LED> lamps = new HashMap<>();
// ... 构造器与其它方法 ...
@Override
public boolean equals(Object o) {
if (this == o) return true; // 引用相同，直接返回
if (o == null || getClass() != o.getClass()) return false;
StateMachine that = (StateMachine) o;
return Objects.equals(lamps, that.lamps); // 使用 Objects.equals 安全比较 Map
}
@Override
public int hashCode() {
return Objects.hash(lamps); // 自动处理 null，与 equals 逻辑一致
}
}⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
-
LED类本身也需正确实现equals()和hashCode()，否则lamps的比较将失效（例如HashMap.equals()会递归调用每个LED的equals()）； - 所有参与比较的字段应为
final或确保运行时不可变，避免哈希码在对象存入集合后发生改变； - 推荐使用
Objects.equals()和Objects.hash()（JDK 7+），它们能安全处理null，避免空指针异常； - 若使用 Lombok，可添加
@EqualsAndHashCode(onlyExplicitlyIncluded = true)并标注@EqualsAndHashCode.Include到关键字段，自动生成健壮实现。
总结：equals() 不是“魔法函数”，而是需要开发者明确定义的契约。只有当 equals() 与 hashCode() 协同工作、覆盖所有相关字段、并保持对称性、传递性与一致性时，对象才能在集合操作和逻辑判断中表现可靠。
