JavaIterator遍历集合详解

本文深入解析Java中Iterator遍历集合的核心机制与常见陷阱：重点揭示fail-fast原理及modCount校验如何导致边遍历边调用集合remove()引发ConcurrentModificationException，并强调Iterator.remove()是唯一安全的删除方式；同时对比Iterator与ListIterator的功能差异，说明后者仅适用于List且支持双向操作；介绍forEachRemaining()在只读批量处理中的简洁优势及使用限制；警示泛型擦除下原始类型迭代器带来的ClassCastException风险；最后点明实际开发中最易忽视的坑——误以为加锁可绕过fail-fast，实则需选用CopyOnWriteArrayList等线程安全集合。内容兼具原理深度与实战指导性，直击Java集合遍历的痛点与误区。

为什么不能边遍历边用集合的remove()方法

直接调用 ArrayList.remove() 或 HashSet.remove() 在增强 for 循环或手动 while 遍历时会抛出 ConcurrentModificationException。这是因为 Java 集合的迭代器默认是“快速失败”（fail-fast）机制，底层通过 modCount 检查结构是否被意外修改。

正确做法是只通过 Iterator.remove() 删除当前元素——它会同步更新 modCount，避免异常。

• 错误写法：

  for (String s : list) { if (s.isEmpty()) list.remove(s); }

• 正确写法：

  Iterator it = list.iterator();
  while (it.hasNext()) {
    String s = it.next();
    if (s.isEmpty()) it.remove(); // ✅ 唯一安全的删除方式
  }

Iterator与ListIterator的区别在哪

Iterator 是单向遍历接口，只能从头到尾调用 next()；ListIterator 是它的子接口，仅适用于 List 实现类（如 ArrayList、LinkedList），支持双向移动和元素替换/插入。

常见误用是试图对 Set 或 Map.keySet() 调用 listIterator()，会抛出 UnsupportedOperationException。

• Iterator 提供：hasNext()、next()、remove()
• ListIterator 额外提供：hasPrevious()、previous()、nextIndex()、previousIndex()、set()、add()
• 获取方式不同：list.iterator() vs list.listIterator()（或带索引的 list.listIterator(3)）

forEachRemaining()适合什么场景

Iterator.forEachRemaining() 是 Java 8 新增的默认方法，接收一个 Consumer，对剩余未遍历元素批量执行操作。它比传统 while 循环更简洁，且内部已处理好异常传播和性能优化。

适用于「只读遍历 + 简单处理」，比如日志打印、状态校验、统计计数等；但不适用于需要提前中断、条件跳过或边遍历边修改的逻辑。

• 简洁写法：

  iterator.forEachRemaining(s -> System.out.println("Got: " + s));

• 注意：一旦调用 forEachRemaining()，后续再调用 next() 会抛出 NoSuchElementException —— 它会消耗完所有剩余元素
• 底层其实仍是循环，但省去了显式状态管理，也规避了手写 while 时漏写 hasNext() 判断的风险

泛型擦除下如何避免ClassCastException

如果用原始类型声明迭代器（如 Iterator it = list.iterator()），编译期不检查类型，运行时取值可能抛 ClassCastException。这是泛型擦除带来的典型陷阱。

必须始终使用带泛型的 Iterator 形式，并确保集合本身也是参数化类型，否则类型安全无法保障。

• 危险写法：

  ArrayList list = new ArrayList();
  list.add("a"); list.add(123);
  Iterator it = list.iterator();
  String s = (String) it.next(); // ✖️ 运行时报错

• 安全写法：

  ArrayList list = new ArrayList();
  list.add("a");
  // list.add(123); // 编译报错，杜绝混入

• IDE 通常会在原始类型迭代器上标黄警告：“Iterator is raw type”——别忽略它

实际项目里最常踩的坑不是不会写循环，而是忘了 Iterator.remove() 是唯一安全删除方式，或者在多线程环境下误以为加锁就能绕过 fail-fast——其实不行，得换用 CopyOnWriteArrayList 或 ConcurrentHashMap 这类线程安全集合。

今天关于《JavaIterator遍历集合详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！