Java中HashMap无直接判断键值对的方法，需用Objects.equals(map.get(key), value)安全高效判断，它正确处理null；containsValue()因不关联键且O(n)效率低而不适用。

Java 中 HashMap 本身没有直接判断“是否包含指定键值对”的内置方法，必须分别检查键是否存在且对应值是否相等。这是因为 containsKey() 只管键，containsValue() 只管值（且效率低），而 equals() 在 HashMap 层面不用于比较键值对组合。

用 get() + Objects.equals() 判断键值对存在

最常用、高效且推荐的方式：先通过键获取值，再与目标值安全比较。

• 调用 map.get(key) 获取当前值（可能为 null）
• 使用 java.util.Objects.equals(currentValue, expectedValue) 比较，它能正确处理 null 值
• 避免直接用 == 或 currentValue.equals(expectedValue)，防止空指针

示例：

Map<String, Integer> map = new HashMap<>();
map.put("a", 1);
map.put("b", null);

boolean hasPair = Objects.equals(map.get("b"), null); // true
boolean hasPair2 = Objects.equals(map.get("c"), 5);   // false（key 不存在，get 返回 null，equals(null, 5) → false）

注意 containsValue() 不适合判断键值对

containsValue(value) 仅检查该值是否在任意键下存在，完全不关心是哪个键关联的。

立即学习“Java免费学习笔记（深入）”；

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

• 即使键不匹配，只要值存在就返回 true
• 时间复杂度为 O(n)，遍历全部值，性能差
• 无法区分 {"x": 1} 和 {"y": 1} —— 两者对 containsValue(1) 都返回 true

自定义工具方法提升复用性

如果项目中频繁需要判断键值对，可封装一个静态工具方法：

public static <K, V> boolean containsEntry(Map<K, V> map, K key, V value) {
    return Objects.equals(map.get(key), value);
}

调用时简洁清晰：

if (containsEntry(map, "user_id", 1001)) { ... }

特殊情况：值类型为 null 时的含义要明确

HashMap 允许 null 值，所以 map.get(key) == null 有两种可能：

• 键不存在（返回 null）
• 键存在，但对应值就是 null

因此不能靠 get() == null 判断键是否存在；必须结合 containsKey() 才能区分。但在判断键值对时，Objects.equals(map.get(key), null) 正确涵盖这两种情况 —— 它只关心“当前键映射的值是否等于 null”，语义准确。