在 Java 中，判断 Map 的一个 key 是否存在，主要有以下几种方法,它们各有特点和使用场景。

containsKey(Object key) - 最常用、最直接的方法

这是官方 Map 接口中定义的标准方法，专门用于检查 Map 中是否包含指定的 key。

特点：

• 语义清晰：方法名 containsKey 直白地表达了它的功能。
• 性能高：对于 HashMap 和 LinkedHashMap，其时间复杂度平均为 O(1)，对于 TreeMap，时间复杂度为 O(log n)。
• 返回布尔值：直接返回 true 或 false，非常适合用于 if 条件判断。

示例代码：

import java.util.HashMap;
import java.util.Map;
public class MapContainsKeyExample {
    public static void main(String[] args) {
        Map<String, Integer> studentScores = new HashMap<>();
        studentScores.put("Alice", 95);
        studentScores.put("Bob", 88);
        studentScores.put("Charlie", 76);
        // 检查存在的 key
        String keyToCheck1 = "Bob";
        if (studentScores.containsKey(keyToCheck1)) {
            System.out.println("学生 " + keyToCheck1 + " 的分数存在: " + studentScores.get(keyToCheck1));
        } else {
            System.out.println("学生 " + keyToCheck1 + " 不在名单中。");
        }
        // 检查不存在的 key
        String keyToCheck2 = "David";
        if (studentScores.containsKey(keyToCheck2)) {
            System.out.println("学生 " + keyToCheck2 + " 的分数存在: " + studentScores.get(keyToCheck2));
        } else {
            // 这部分代码会被执行
            System.out.println("学生 " + keyToCheck2 + " 不在名单中。");
        }
    }
}

输出：

学生 Bob 的分数存在: 88
学生 David 不在名单中。

通过 get(Object key) 方法（不推荐）

虽然 get(key) 方法也可以用来判断 key 是否存在，但这是一种不推荐的做法,因为它不够清晰且可能带来额外的开销。

原理：

• key 存在，get(key) 返回对应的 value（可能为 null）。
• key 不存在，get(key) 返回 null。

问题所在：

1. 语义模糊：你无法区分“key 不存在”和“key 存在但其 value null”这两种情况,这会导致逻辑错误。
2. 性能略低：get(key) 方法本身可能比 containsKey(key) 做了更多的工作（在 HashMap 中，get 和 containsKey 的底层逻辑几乎一样，但调用 containsKey 在意图上更明确）。

错误示例（容易出错）：

Map<String, Integer> map = new HashMap<>();
map.put("key1", null); // 故意将 value 设为 null
// 错误的判断方式
if (map.get("key1") != null) {
    System.out.println("key1 存在且值不为 null"); // 这行代码永远不会被执行，但 key1 实际上是存在的
} else {
    System.out.println("key1 不存在或其值为 null"); // 这里会误判为 key1 不存在
}
if (map.get("key2") != null) {
    System.out.println("key2 存在且值不为 null"); // key2 确实不存在
} else {
    System.out.println("key2 不存在或其值为 null"); // 这里的判断是正确的
}

正确但冗余的写法（如果想用 get）： 如果你能确保你的 Map 中不允许 value 为 null，那么可以用 get(key) != null 来判断，但这需要额外的约束，不如 containsKey 通用。

// 只有在确保 value 不为 null 的情况下才安全
if (map.get("key1") != null) { // 此时可以安全地判断 key1 存在
    // ...
}

Java 8+ getOrDefault(Object key, V defaultValue) 方法

从 Java 8 开始，Map 接口引入了 getOrDefault 方法，它也可以用来间接判断 key 是否存在,并且通常用于获取值或提供一个默认值的场景。

原理：

• key 存在，返回其关联的 value。
• key 不存在，返回你指定的 defaultValue。

如何用于判断 key 存在： 通过比较返回结果是否等于 defaultValue。

示例代码：

import java.util.HashMap;
import java.util.Map;
public class MapGetOrDefaultExample {
    public static void main(String[] args) {
        Map<String, String> countryCapitals = new HashMap<>();
        countryCapitals.put("China", "Beijing");
        countryCapitals.put("Japan", "Tokyo");
        countryCapitals.put("USA", "Washington, D.C.");
        String country = "Japan";
        String defaultCapital = "Capital not found";
        // 获取首都，如果不存在则使用默认值
        String capital = countryCapitals.getOrDefault(country, defaultCapital);
        // 判断 key 是否存在
        if (capital != defaultCapital) {
            System.out.println(country + " 的首都是: " + capital);
        } else {
            System.out.println(country + " 不在 Map 中。");
        }
        country = "France";
        capital = countryCapitals.getOrDefault(country, defaultCapital);
        // 这部分代码会被执行
        if (capital != defaultCapital) {
            System.out.println(country + " 的首都是: " + capital);
        } else {
            System.out.println(country + " 不在 Map 中。");
        }
    }
}

输出：

Japan 的首都是: Tokyo
France 不在 Map 中。

适用场景： 当你不仅想知道 key 是否存在，还想在不存在时立即使用一个默认值时，getOrDefault 非常方便，它将“检查”和“获取默认值”两个操作合二为一,代码更简洁。

总结与最佳实践

核心建议：

当你只想判断 Map 中是否存在某个 key 时，请始终使用 map.containsKey(key)。 这是最清晰、最正确、最符合 Java 编码规范的方式。