Java里Map遍历有哪些常见方式_Java键值遍历技巧说明

最推荐使用 for (Map.Entry entry : map.entrySet()) 遍历，兼顾可读性、性能（避免重复哈希查找）和兼容性（Java 5+），但需判空、写全泛型、禁止遍历时结构修改。

最常用、最推荐的方式是 for (Map.Entry entry : map.entrySet()) —— 它兼顾可读性、性能和 JDK 兼容性（Java 5+），且不会额外触发 map.get() 查找。

用 entrySet() 遍历键值对（推荐首选）

这是绝大多数场景下的最优解：一次获取键和值，避免重复哈希查找。底层直接访问内部 Node 数组，不调用 get()，性能比 keySet() + get() 高约 10%～15%，尤其在大 Map 中更明显。

• 必须检查空引用：if (map != null && !map.isEmpty())，否则 map.entrySet() 在 null 上会抛 NullPointerException
• 泛型务必写全，如 Map.Entry，避免运行时类型擦除导致的 ClassCastException
• 不要在遍历中修改 Map 结构（如 put()、remove()），否则会触发 ConcurrentModificationException；如需删除，请用 Iterator.remove()

Map map = new HashMap<>();
map.put("a", 1);
map.put("b", 2);
for (Map.Entry entry : map.entrySet()) {
System.out.println("Key: " + entry.getKey() + ", Value: " + entry.getValue());
}

只遍历 key 或 value 时用 keySet() 和 values()

当你明确只需要键或只处理值（比如统计所有分数、收集所有用户名），用 keySet() 或 values() 更简洁、稍快，且语义更清晰。

• keySet() 遍历时若还需 value，**必须调用 map.get(key)** —— 这会多一次哈希计算和可能的链表/红黑树遍历，小 Map 不明显，但万级数据下可观测到延迟上升
• values() 返回的是 Collection，不保证顺序（除非用 LinkedHashMap），也不能反查 key
• 二者都不支持修改原 Map（如 remove() 会抛 UnsupportedOperationException），想安全删元素请回到 entrySet().iterator()

// 只要 key
for (String key : map.keySet()) {
    System.out.println("Key: " + key);
}
// 只要 value
for (Integer value : map.values()) {
System.out.println("Value: " + value);
}

需要控制遍历流程或兼容老 JDK 时用 Iterator

当你要在遍历中途 break、continue，或需在 Android（旧版 ART）、Java 6/7 环境下运行，Iterator 是唯一可控、兼容性最强的方式。它也允许安全删除元素。

灵枢SparkVertex

零代码AI应用开发平台

下载

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

• 务必用 entrySet().iterator()，而不是 keySet().iterator() 再去 get() —— 后者仍是两趟操作
• 删除必须调用 iterator.remove()，不能调用 map.remove()，否则立刻抛异常
• 泛型不写（裸类型）虽能跑，但极易引发类型错误，不建议在现代项目中使用

Iterator> it = map.entrySet().iterator();
while (it.hasNext()) {
    Map.Entry entry = it.next();
    if (entry.getValue() > 1) {
        it.remove(); // 安全删除
    }
}

Java 8+ 场景：用 forEach() 或 stream() 做函数式处理

适合做过滤、映射、聚合等声明式操作，代码更紧凑，但要注意：它不是“更快”，而是“更表达意图”。实际性能略低于传统 for 循环（有 Lambda 创建开销、Stream pipeline 构建成本）。

• forEach() 是终端操作，不可链式继续；stream() 可组合 filter()、map()、collect()，但注意 parallelStream() 对 Map 遍历无意义（HashMap 本身无序且非分段）
• 所有 Stream 操作默认不保证顺序（HashMap 无序），如需有序请用 LinkedHashMap 或显式 sorted()
• 别在 forEach() 里修改外部变量（非 final 或 effectively final），编译会报错

map.forEach((key, value) -> {
    System.out.println("Key: " + key + ", Value: " + value);
});
// 过滤出 value > 1 的项并转成 list
List> filtered = map.entrySet().stream()
.filter(entry -> entry.getValue() > 1)
.collect(Collectors.toList());

真正容易被忽略的点是：遍历前是否判空、遍历中是否误删结构、以及不同方式对 Map 实现类（如 TreeMap vs HashMap）的顺序影响——entrySet() 和 keySet() 在 TreeMap 中天然有序，在 HashMap 中则完全无序，这点不看文档很容易踩坑。