Java 遍历 Map 集合的五种方式详解

一、为什么 Map 的遍历值得单独讨论

在 Java 集合体系中，Map 是最常用的数据结构之一，它以键值对形式存储数据，广泛用于缓存、配置表、索引映射等场景。然而与 List、Set 不同，Map 并不直接实现 Iterable 接口，无法直接使用增强 for 循环遍历其”元素”，因为 Map 存储的是键、值以及键值对三种视图，而非单一元素。这就导致遍历 Map 必须先明确”遍历什么”——是只要键、只要值，还是需要键值对，进而选择不同的视图与遍历方式。

不同的遍历方式在性能、可读性、内存开销以及并发安全性上存在明显差异。理解这些差异，是编写高效且健壮代码的基础。下面按”视图获取 → 遍历方式 → 适用场景”的思路，逐一介绍五种主流方式。

二、方式一：通过 keySet() 遍历键

keySet() 返回 Map 中所有键组成的 Set 视图。由于 Set 实现了 Iterable，可以直接用增强 for 循环：

Map<String, Integer> map = new HashMap<>();
map.put("Java", 1);
map.put("MySQL", 2);
map.put("Redis", 3);
for (String key : map.keySet()) {
    Integer value = map.get(key);
    System.out.println(key + " = " + value);
}

这种方式语义清晰，适合”以键为主、顺便取值”的场景。但需要注意：每次循环都调用一次 map.get(key)，在 HashMap 中虽然平均是 O(1)，但在数据量大或哈希冲突较多时会产生额外的查找开销。如果业务只需要键本身，那么这是最简洁的选择；如果同时需要值，则应优先考虑 entrySet。

三、方式二：通过 values() 遍历值

当业务只关心 Map 中的值、不关心对应的键时，使用 values() 最为直接：

for (Integer value : map.values()) {
    System.out.println(value);
}

values() 返回的是值的 Collection 视图，遍历开销小、代码简洁。其局限也显而易见：无法在遍历过程中获取键，若需要按键做判断或二次处理，就不适用。此外，由于返回的是视图而非副本，遍历期间对 Map 的结构性修改同样可能引发并发修改异常。

四、方式三：通过 entrySet() 遍历键值对

entrySet() 返回 Set<Map.Entry<K, V>>，每个元素同时封装了键和值，是”既要键又要值”场景下的推荐方式：

for (Map.Entry<String, Integer> entry : map.entrySet()) {
    System.out.println(entry.getKey() + " = " + entry.getValue());
}

相比 keySet 加 get 的组合，entrySet 在一次遍历中同时拿到键值，避免了重复查找，在大多数实现中性能更优。Map.Entry 还提供了 setValue() 方法，可以在遍历中直接修改对应的值（注意这属于修改值而非结构性修改，通常不会触发并发修改异常，但具体行为依赖实现）。

五、方式四：使用 Iterator 显式遍历

Iterator 是集合专用的遍历接口，它不依赖索引，因此无论底层是数组还是链表结构，都可以统一使用。获取方式是通过集合视图的 iterator() 方法：

Iterator<Map.Entry<String, Integer>> it = map.entrySet().iterator();
while (it.hasNext()) {
    Map.Entry<String, Integer> entry = it.next();
    System.out.println(entry.getKey() + " = " + entry.getValue());
}

Iterator 的工作原理像一个”光标”：初始时停在第一个元素之前，hasNext() 判断当前位置之后是否还有元素，next() 先取出当前指向的元素、再把光标后移一位。它的核心价值在于 remove() 方法——这是遍历过程中唯一安全的删除方式。若在迭代器遍历时直接调用 Map 的 remove() 或 put() 改变集合长度，迭代器内部维护的预期修改计数器与实际修改次数不一致，就会抛出 ConcurrentModificationException；而使用 it.remove() 删除迭代器最后一次返回的元素，则可以安全地在遍历中剔除数据。

六、方式五：forEach 与 Stream（Java 8+）

Java 8 引入的 forEach 让遍历写法进一步简化：

map.forEach((k, v) -> System.out.println(k + " = " + v));

其底层仍是基于 entrySet 的遍历，但以函数式接口表达，可读性更强。需要注意的是，lambda 中若引用外部局部变量，该变量必须是 effectively final，因此不适合在 forEach 中做累加计数之类的操作；同时 forEach 中修改 Map 结构同样不安全。

若需要过滤、映射、聚合等复杂处理，Stream 更合适：

map.entrySet().stream()
   .filter(e -> e.getValue() > 1)
   .forEach(e -> System.out.println(e.getKey()));

Stream 适合声明式数据处理，但存在额外的流对象创建开销，简单遍历场景下不必强行使用。

七、常见陷阱与规避建议

1. 越界异常：在 hasNext() 返回 false 后强行调用 next() 会抛出 NoSuchElementException。规范做法是每次 next() 前先用 hasNext() 检查。

2. 多次调用 next()：在一个循环体内多次调用 it.next()，会导致跳过元素，或在最后一次循环时越界。应保持”一次 hasNext() 对应一次 next()”，先把 next() 的结果赋给局部变量再使用。

3. 并发修改异常：遍历期间用 Map 自身方法增删元素会触发 ConcurrentModificationException。遍历中删除应使用 it.remove()；若需并发读写，应考虑 ConcurrentHashMap 等并发容器或先复制再遍历。

4. 指针复位问题：while 循环结束后迭代器指针已到末尾，想再次遍历必须重新调用 iterator() 获取新实例，指针不会自动复位。

5. 增强 for 的本质：增强 for 循环底层就是迭代器，因此同样受上述并发修改规则约束，不能误以为它”更安全”。

八、五种方式对比与选型建议

方式	遍历内容	适用场景	主要注意点
keySet	键	只需键，或键为主	取值需额外 get
values	值	只需值	拿不到键
entrySet	键值对	键值都需要的首选	性能较优
Iterator	键值对等视图	遍历中需安全删除	用 it.remove()
forEach/Stream	键值对	函数式、复杂数据处理	变量需 effectively final

总体原则：只需键用 keySet，只需值用 values，键值都要用 entrySet；需要在遍历中删除元素时用 Iterator；追求简洁或做数据管道处理时用 forEach 与 Stream。理解每种方式背后的视图机制与迭代器原理，才能在性能与安全之间做出合理权衡。