要支持增强for循环，集合类必须实现Iterable接口并提供每次返回新迭代器实例的iterator()方法，确保遍历状态隔离；迭代器需正确实现hasNext()和next()，remove()方法可选但若实现须满足调用约束。
要在自定义集合中支持增强 for 循环（for (T item : collection)），必须正确实现 Iterable<t></t> 接口，核心是提供一个返回 Iterator<t></t> 的 iterator() 方法。关键不在于“继承”或“重写”，而在于逻辑上能持续、安全、独立地遍历元素。
实现 Iterable 的基本结构
你的集合类需声明实现 Iterable<e></e>，并提供 public Iterator<e> iterator()</e> 方法。该方法每次调用都应返回**新的、独立的迭代器实例**，避免多个 for 循环互相干扰。
例如：
public class MyList<e> implements Iterable<e> {
private final Object[] elements;
private int size;
// 构造、add 等方法略...
@Override
public Iterator<e> iterator() {
return new MyIterator();
}
private class MyIterator implements Iterator<e> {
private int cursor = 0;
@Override
public boolean hasNext() {
return cursor
</e></e></e></e>注意迭代器的状态隔离与线程安全性
每个 iterator() 调用必须返回新对象。如果复用同一个迭代器实例（比如返回 this 或缓存单例），会导致多个增强 for 循环共享状态，产生不可预期行为（如提前结束、并发修改异常）。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- ✅ 正确：每次
iterator()都 new 一个新迭代器 - ❌ 错误：返回 this（除非类本身同时是 Iterator）、或 static 单例迭代器
- ⚠️ 注意：标准迭代器不保证线程安全；若需多线程遍历，应确保底层数据不可变，或在迭代器内加锁（通常不推荐，优先用
Collections.unmodifiableList等）
支持 remove() 的注意事项
如果希望增强 for 中调用 iterator().remove() 生效（虽然增强 for 语法本身不直接暴露 remove），迭代器的 remove() 方法必须：
- 仅在刚调用过
next()后才允许调用 - 实际从集合中删除对应元素（需同步更新集合状态，如
size--、移动后续元素等） - 多次调用或未调用
next()就调用，应抛IllegalStateException
大多数自定义集合若不打算支持删除操作，直接抛 UnsupportedOperationException 更清晰安全。
利用现有工具简化实现（Java 8+）
若底层已有数组或 List，可用 Stream 或匿名内部类快速构建迭代器，减少样板代码：
@Override
public Iterator<e> iterator() {
return Arrays.stream((E[]) elements)
.limit(size)
.iterator();
}</e>
但注意：这会创建额外对象和 Stream 开销，生产环境建议手写轻量迭代器；调试或原型阶段可接受。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
