for-each 循环遍历 Iterable 实现类详解

for-each循环看似简洁优雅，实则是Java编译器为Iterator设计的精巧语法糖，其本质是自动展开为iterator()、hasNext()和next()三步迭代操作；要真正掌握它，必须理解Iterable接口的核心契约——每次调用iterator()都必须返回全新的、状态独立的迭代器实例，同时认清其内在限制：支持fail-fast并发检测但不支持倒退、无法修改集合结构或获取索引；通过剖析ArrayList等内置实现及亲手编写CountDown等自定义Iterable类，你能穿透语法表象，看清“Iterable生产迭代器、Iterator驱动遍历、for-each仅是胶水”的运行本质，从而在实际开发中做出更安全、更精准的遍历选择。

for-each 循环（增强型 for 循环）本质是编译器对 Iterator 的语法糖，它要求遍历对象实现 Iterable 接口，并通过其 iterator() 方法获取迭代器。理解它，关键在于看清“谁在调用谁”以及“每一步发生了什么”。

for-each 背后实际执行的是 Iterator 三步操作

当你写：

编译器会自动翻译为类似以下代码：

也就是说，for-each 并不神秘——它只是帮你省略了显式创建迭代器、反复调用 hasNext() 和 next() 的模板代码。

Iterable 接口的核心就是提供 iterator() 方法

任何类想支持 for-each，就必须实现 Iterable 接口，即提供一个返回 Iterator 的方法：

• public Iterator iterator() 是唯一抽象方法
• 该方法必须每次调用都返回一个“新鲜的”迭代器实例（不能复用或返回 this）
• 返回的 Iterator 必须正确维护内部状态（如当前索引、是否已遍历完等）

例如 ArrayList 的 iterator() 返回的是内部私有类 Itr 实例，它持有数组引用和游标 cursor，next() 就是根据 cursor 取元素并自增。

迭代器运行时的关键细节不能忽略

• fail-fast 机制：多数集合（如 ArrayList、HashMap 的 keySet）的迭代器在检测到结构被并发修改时（比如遍历时调用 list.remove()），会立即抛出 ConcurrentModificationException
• remove() 是可选操作：Iterator 的 remove() 方法不是必须实现的；若未实现，调用会抛 UnsupportedOperationException
• 迭代器不支持“倒退”：Iterator 只能单向前进；若需双向遍历，请用 ListIterator（List 特有）
• for-each 无法获取索引或修改集合结构：它只适合“只读遍历”，要删元素或需要下标，必须显式使用 Iterator 或传统 for 循环

自定义 Iterable 类帮助你真正看懂机制

写一个简单计数器类，手动实现 Iterable：

然后就能直接 for-each：

这个例子清晰暴露了：Iterable 是“生产者”，Iterator 是“消费者代理”，而 for-each 是让两者协作的简洁写法。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~