Iterator.forEachRemaining() 是 Java 8 提供的便捷方法，用于在手动调用 next() 处理部分元素后，将剩余未访问元素一次性交由 Consumer 处理，避免重复判断 hasNext() 和手动循环。
Iterator.forEachRemaining() 是 Java 8 引入的便捷方法，用于在手动调用 next() 遍历部分元素后，将迭代器中**剩余未访问的元素**一次性交给 Consumer 处理，避免重复判断 hasNext() 和手动循环。
适用场景：混合遍历 + 批量处理
当你需要先检查或单独处理前几个元素（比如跳过表头、识别分隔符、提取元数据），再把剩下的全部交给统一逻辑处理时，这个方法特别自然。例如：
- 解析 CSV 文件，跳过第一行标题，后续所有数据行统一解析
- 日志流中识别起始标记后，批量消费后续有效日志条目
- 集合中查找首个满足条件的元素后，对余下所有元素执行清理或转换
基本用法：先手动 next()，再 forEachRemaining()
关键点：调用 forEachRemaining() 前，必须已通过 next() 移动了迭代器位置；它只作用于当前 cursor 之后的元素，且内部会自动推进指针，无需也不应再调用 next()。
示例：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
List<String> list = Arrays.asList("Header", "A", "B", "C", "D");
Iterator<String> it = list.iterator();
// 手动跳过第一个元素（标题）
if (it.hasNext()) {
String header = it.next(); // 消费 "Header"
System.out.println("Skipped header: " + header);
}
// 剩余所有元素一次性打印
it.forEachRemaining(System.out::println); // 输出 A, B, C, D（每行一个）
注意事项与常见误区
-
不可逆向或重置：
forEachRemaining()会彻底消耗掉剩余元素，之后再调用hasNext()返回false，无法回退 -
线程不安全：和普通 Iterator 一样，不支持并发修改；若遍历中底层集合被修改，仍会抛
ConcurrentModificationException - 不能替代 for-each 循环主体：它只是“剩余部分”的快捷处理，不是整个遍历的替代方案；不要试图用它来写带 break/continue 的复杂逻辑
- Consumer 内部可抛异常：如果传入的 Lambda 抛出受检异常，需自行包装为运行时异常，或使用工具方法转换
对比传统 while 循环写法
不用 forEachRemaining() 时，等效代码更啰嗦：
// 手动跳过 header 后，用 while 处理剩余
if (it.hasNext()) it.next(); // skip
while (it.hasNext()) {
System.out.println(it.next());
}
而 forEachRemaining() 更简洁、意图更清晰，也减少手误（如漏写 hasNext() 判断）。
