1. 概述
在 Java 编程中，我们经常需要判断一个 Map 是否包含某个特定的键。本文将介绍几种常见的做法，重点分析 containsKey 和 get 方法的使用场景与注意事项。
2. 使用 containsKey 方法
查看 Java 官方文档中对 Map#containsKey 的描述：
如果此映射包含指定键的映射关系，则返回 true。
这个方法就是专门用来判断键是否存在的，语义清晰、直接高效。
来看一个简单的例子：
@Test
public void whenKeyIsPresent_thenContainsKeyReturnsTrue() {
Map<String, String> map = Collections.singletonMap("key", "value");
assertTrue(map.containsKey("key"));
assertFalse(map.containsKey("missing"));
}
✅ 结论：
- 当你需要明确知道某个 key 是否存在于 map 中时，优先使用
containsKey。 - 该方法不关心 value 是什么，只关心 key 是否存在。
3. 使用 get 方法判断（慎用）
虽然也可以通过 get(key) != null 来判断键是否存在，但这种方式存在风险，尤其当 value 可能为 null 时。
先看官方文档对 Map#put 的说明：
若 map 不允许 null 键或值，并且传入了 null，则会抛出 NullPointerException。
⚠️ 注意：像 HashMap 这样的实现是允许 value 为 null 的。这意味着即使 key 存在，get(key) 也可能返回 null。
举个例子：
@Test
public void whenKeyHasNullValue_thenGetStillWorks() {
Map<String, String> map = Collections.singletonMap("nothing", null);
assertTrue(map.containsKey("nothing"));
assertNull(map.get("nothing"));
}
❌ 问题来了：
- 如果你写的是
if (map.get("nothing") != null)来判断 key 是否存在，那就会出错。 - 因为 key 存在，但 value 是 null，导致你误判为 key 不存在。
✅ 结论：
- 如果你是想判断 key 对应的 value 是否非空，可以用
get配合 null 判断。 - 如果只是想确认 key 是否存在，那就老老实实用
containsKey，别给自己挖坑。
4. 总结
| 方法 | 用途 | 是否推荐用于判断 key 存在 | 注意事项 |
|---|---|---|---|
containsKey |
明确判断 key 是否存在 | ✅ 强烈推荐 | 无 |
get |
获取 value 并判断是否为 null | ❌ 不推荐仅用于判断 key | value 可能为 null 时不可靠 |
📌 一句话总结：
检查 key 是否存在，请用 containsKey，简单粗暴还安全；用 get 容易踩到 value 为 null 的坑。
如需查看完整代码示例，可访问 GitHub 项目地址。