Java equals() 方法深度解析：從 Object 到 String 的演進與最佳實踐

Java equals() 方法核心機制詳解

equals() 是 Java 對象比較的核心方法，但其默認行為常被誤解。本文從源碼層面剖析 Object.equals() 與 String.equals() 的差異，並總結自定義類重寫的關鍵要點。

Object 基類默認實現

public boolean equals(Object obj) {
    return (this == obj); // 僅比較引用地址
}

結論：默認 equals() 與 == 行為完全一致，均為引用比較，而非內容比較。

String 類重寫實現

public boolean equals(Object anObject) {
    // 1. 引用相同直接返回 true
    if (this == anObject) {
        return true;
    }
    // 2. 類型檢查
    if (anObject instanceof String) {
        String anotherString = (String) anObject;
        int n = count; // 字符數量
        // 3. 長度快速失敗
        if (n == anotherString.count) {
            char v1[] = value;
            char v2[] = anotherString.value;
            int i = offset;
            int j = anotherString.offset;
            // 4. 逐字符比較
            while (n-- != 0) {
                if (v1[i++] != v2[j++]) {
                    return false;
                }
            }
            return true;
        }
    }
    return false;
}

String.equals() 核心邏輯

1. 引用快速判斷：同一對象直接返回 true
2. 類型安全檢查：使用 instanceof 確保比較對象為 String
3. 長度優先比較：長度不同直接返回 false，避免無效字符遍歷
4. 字符數組逐位比較：底層調用 char[] 逐個比對字符值

常見誤區與正確認知

自定義類重寫 equals() 規範

根據 Java 語言規範，重寫 equals() 必須滿足五大特性：

1. 自反性：x.equals(x) == true
2. 對稱性：x.equals(y) == y.equals(x)
3. 傳遞性：x.equals(y) && y.equals(z) → x.equals(z)
4. 一致性：多次調用結果不變（前提是對象未被修改）
5. 非空性：x.equals(null) == false

標準重寫模板（以 User 類為例）

public class User {
    private Long id;
    private String username;
    private String email;

    @Override
    public boolean equals(Object o) {
        // 1. 引用相同
        if (this == o) return true;
        // 2. 空值或類型不匹配
        if (o == null || getClass() != o.getClass()) return false;
        // 3. 轉型並比較核心字段
        User user = (User) o;
        return Objects.equals(id, user.id) &&
               Objects.equals(username, user.username) &&
               Objects.equals(email, user.email);
    }

    @Override
    public int hashCode() {
        // 必須同時重寫 hashCode()，保持 equals-hashCode 契約
        return Objects.hash(id, username, email);
    }
}

關鍵注意事項

• 必須重寫 hashCode()：equals() 相等的對象，hashCode() 必須相等，否則在 HashMap/HashSet 中會出現異常行為
• 使用 Objects.equals()：JDK 7+ 提供空值安全的比較工具，避免手動 null 判斷
• 優先比較基本類型/不可變對象：先比較 id 等唯一標識，提升性能
• 考慮繼承場景：使用 getClass() 而非 instanceof 保證對稱性（Effective Java 建議）

IDE 自動生成建議

現代 IDE（IntelliJ IDEA、Eclipse）均支援根據字段自動生成規範的 equals()/hashCode()，建議使用並審查生成代碼，而非手寫。

總結：理解 equals() 默認行為與重寫規範，是正確使用集合框架、避免業務邏輯 Bug 的基礎。自定義實體類必須配對重寫 equals() 和 hashCode()。