在 Java 中，判断 Map 中是否存在某个 key，主要有以下几种常用方法，它们各有特点，适用于不同的场景。
（图片来源网络，侵删）
核心方法
containsKey(Object key) - 最常用、最标准的方法
这是 Map 接口定义的标准方法，专门用于检查 Map 中是否包含指定的 key。
- 返回值：
boolean。Map包含该key的映射关系，则返回true；否则返回false。 - 特点：语义清晰，代码可读性高，是判断
key是否存在的首选方式。
示例代码：
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", 92);
String keyToCheck = "Bob";
String keyNotPresent = "David";
// 使用 containsKey 检查 key 是否存在
if (studentScores.containsKey(keyToCheck)) {
System.out.println("学生 " + keyToCheck + " 的分数是: " + studentScores.get(keyToCheck));
} else {
System.out.println("学生 " + keyToCheck + " 不在列表中。");
}
if (studentScores.containsKey(keyNotPresent)) {
System.out.println("学生 " + keyNotPresent + " 的分数是: " + studentScores.get(keyNotPresent));
} else {
System.out.println("学生 " + keyNotPresent + " 不在列表中。");
}
}
}
输出：
学生 Bob 的分数是: 88
学生 David 不在列表中。get(Object key) != null - 一种常见的替代方法
有些人习惯通过获取 key 对应的 value，然后判断 value 是否为 null 来间接判断 key 是否存在。
（图片来源网络，侵删）
-
返回值：
V（value的类型）。key存在，返回其对应的value；key不存在，返回null。 -
⚠️ 重要陷阱：
key不存在：map.get("unknown_key")会返回null。key存在，但其valuenull：map.put("some_key", null);map.get("some_key")也会返回null。
map.get(key) != null无法区分“key不存在”和“key存在但value为null”这两种情况，这可能导致逻辑错误。
示例代码（演示陷阱）：
import java.util.HashMap;
import java.util.Map;
public class MapGetNullTrapExample {
public static void main(String[] args) {
Map<String, String> settings = new HashMap<>();
settings.put("timeout", "30"); // key 存在，value 不为 null
settings.put("debugMode", null); // key 存在，value 为 null
// "maxConnections" 这个 key 完全不存在
String key1 = "timeout";
String key2 = "debugMode";
String key3 = "maxConnections";
// 错误的判断方式
System.out.println("--- 使用 get() != null 的错误判断 ---");
// 情况1: key 存在，value 不为 null
System.out.println("检查 '" + key1 + "': " + (settings.get(key1) != null)); // 输出 true，正确
// 情况2: key 存在，value 为 null (陷阱!)
System.out.println("检查 '" + key2 + "': " + (settings.get(key2) != null)); // 输出 false，错误地认为 key 不存在
// 情况3: key 不存在
System.out.println("检查 '" + key3 + "': " + (settings.get(key3) != null)); // 输出 false，正确
}
}
输出：
--- 使用 get() != null 的错误判断 ---
检查 'timeout': true
检查 'debugMode': false
检查 'maxConnections': false从输出可以看出,对于 debugMode，get(key) != null 返回了 false，尽管 debugMode 这个 key 是真实存在的。
性能比较
对于大多数 Map 实现（如 HashMap, LinkedHashMap），containsKey(key) 和 get(key) 的时间复杂度都是 O(1)，它们都需要先根据 key 的 hashCode 找到桶的位置，然后比较 key 是否相等。
从性能角度看，两者几乎没有区别，选择哪个主要取决于代码的清晰度和正确性。
总结与最佳实践
| 方法 | 优点 | 缺点 | 推荐场景 |
|---|---|---|---|
map.containsKey(key) |
语义清晰，意图明确，可读性高。 | 无明显缺点。 | 所有用于判断 key 是否存在的场景，这是最标准、最安全的选择。 |
map.get(key) != null |
- | 有陷阱：无法区分 key 不存在和 value 为 null 的情况，容易引发 bug。 |
不推荐用于仅判断 key 是否存在，但如果你的业务逻辑就是需要同时获取 value，并且能确定 value 永远不会是 null，则可以接受。 |
始终优先使用 containsKey(Object key) 方法来判断 Map 中是否存在某个 key。 这能让你的代码更易于理解，并且避免了因 value 为 null 而可能导致的潜在错误。
