一、方法定义

Character.equals() 是 Character 类继承自 Object 的 实例方法，用于比较两个 Character 对象的值是否相等。

方法签名：

public boolean equals(Object obj)

✅ 注意：这是 Character 对象的 equals 方法，不是静态方法。不能用于 char 基本类型。

二、功能说明

  • 比较当前 Character 对象与指定对象 obj 是否“逻辑相等”。
  • 判断标准：
    1. obj 是否为 Character 类型；
    2. 如果是，比较其内部封装的 char 值是否相等。

返回值：

  • true：两个 Character 对象封装的字符相同。
  • false：类型不同或字符值不同。

三、示例代码

示例 1：基本使用

Character c1 = 'A';
Character c2 = 'A';
Character c3 = 'B';

System.out.println(c1.equals(c2)); // true：值相同
System.out.println(c1.equals(c3)); // false：值不同

示例 2：与 null 比较

Character c = 'X';
System.out.println(c.equals(null)); // false（不会抛异常）

示例 3：与非 Character 类型比较

Character c = '5';
System.out.println(c.equals("5"));     // false：类型不同
System.out.println(c.equals(5));       // false：类型不同
System.out.println(c.equals(Character.valueOf('5'))); // true

示例 4：自动装箱中的 equals

char ch = 'z';
Character wrapper = 'z';

// 自动装箱后调用 equals
System.out.println(wrapper.equals(ch)); // 编译错误！ch 是 char，不是 Object

// 正确方式：比较时需对象化
Character chObj = ch;
System.out.println(wrapper.equals(chObj)); // true

四、使用技巧

✅ 技巧 1：安全比较 char 与 Character

char primitive = 'a';
Character wrapper = 'a';

// 正确：将 char 装箱为 Character
boolean isEqual = wrapper.equals(Character.valueOf(primitive));

✅ 技巧 2：避免 == 误用（引用比较）

Character c1 = 'x';
Character c2 = new Character('x');

System.out.println(c1 == c2);      // false（引用不同）
System.out.println(c1.equals(c2)); // true（值相同）

✅ 建议：比较 Character 值时，始终使用 .equals()。

✅ 技巧 3：与 null 安全比较

Character c = getCharFromInput(); // 可能为 null

// 安全写法
boolean isA = c != null && c.equals('A');

// 或使用 Objects.equals
boolean isB = Objects.equals(c, 'B'); // 推荐：null 安全

五、常见错误

❌ 错误 1：对 null 调用 equals → NullPointerException

Character c = null;
boolean result = c.equals('A'); // 运行时抛出 NullPointerException

修正：

boolean result = Objects.equals(c, 'A'); // 推荐
// 或
boolean result = (c != null) && c.equals('A');

❌ 错误 2：用 == 比较值（错误的语义）

Character c1 = Character.valueOf('A');
Character c2 = Character.valueOf('A');
System.out.println(c1 == c2); // 可能 true（缓存），但不可靠

⚠️ Character 缓存范围是 '\u0000' 到 '\u007F'（ASCII），超出范围可能创建新对象。

❌ 错误 3：与字符串比较

Character c = 'a';
System.out.println(c.equals("a")); // 编译通过但返回 false

❌ 逻辑错误："a" 是 String，不是 Character。

六、注意事项

项目 说明
null 安全 调用方为 null 会抛 NPE，建议使用 Objects.equals(a, b)
类型检查 equals 会先检查 obj instanceof Character
大小写敏感 'A' 与 'a' 不相等
性能 高效，仅比较 char 值
缓存机制 Character.valueOf(char) 对 ASCII 字符缓存，影响 == 行为

七、最佳实践与性能优化

✅ 1. 优先使用 Objects.equals()

// 推荐：null 安全
if (Objects.equals(char1, char2)) {
    // 安全比较
}

✅ 2. 避免频繁装箱比较

// 不推荐：频繁装箱
for (int i = 0; i < 10000; i++) {
    if (someCharObj.equals((char) i)) { ... }
}

// 推荐：先拆箱
char value = someCharObj.charValue();
for (int i = 0; i < 10000; i++) {
    if (value == (char) i) { ... } // 直接比较 char
}

✅ 3. 在 switch 中使用 char 值

Character c = getCurrentChar();
switch (c) { // 编译错误！switch 不支持包装类

// 正确做法：拆箱
switch (c.charValue()) {
    case 'A': ...
    case 'B': ...
}

✅ 4. 集合中使用 Character 时注意拆箱

List<Character> chars = Arrays.asList('a', 'b', 'c');
for (Character ch : chars) {
    if (ch.equals('a')) { // 自动拆箱发生在 equals 内部
        // ...
    }
}

八、总结

项目 说明
方法类型 实例方法，public boolean equals(Object obj)
核心功能 比较两个 Character 对象的字符值是否相等
返回值 true 当且仅当 obj 是 Character 且 char 值相同
常见陷阱 null 调用、== 误用、与字符串比较
最佳实践 使用 Objects.equals()、避免 ==、拆箱优化
性能建议 高频比较时先拆箱为 char，避免重复装箱

✅ 一句话总结：

Character.equals() 是比较两个字符对象值是否相等的安全方式，应优先于 == 使用，注意 null 安全性，推荐结合 Objects.equals() 实现健壮、清晰的字符比较逻辑。