要让自定义类支持for-each循环，必须实现iterable接口并每次调用iterator()时返回全新、状态独立的iterator实例，且其hasnext()、next()、remove()方法需逻辑正确、协同工作。
让自定义类支持 for-each 循环，关键不是“加个接口就行”，而是正确实现 Iterable<t></t> 并配套提供合规的 Iterator<t></t> 实例。
必须实现 Iterable 接口
你的容器类（比如 MyList<e></e>）要声明实现 Iterable<e></e>，并重写 iterator() 方法：
- 泛型参数
T必须与容器实际存储的元素类型一致，例如MyList<string></string>就应实现Iterable<string></string> -
iterator()方法不能返回null，也不能复用旧对象——每次调用都得新建一个迭代器实例，否则多个for-each同时使用会互相干扰 - 不实现
Iterable，编译器直接报错：for-each not applicable to type
提供真正可用的 Iterator 实现
iterator() 返回的对象必须是完整实现 Iterator<e></e> 接口的实例，重点是三个方法的逻辑闭环：
-
hasNext()：判断是否还有未访问元素，通常依赖内部游标（如索引或指针）与容器大小/状态比较 -
next()：返回当前元素，并将游标推进；若已无元素，必须抛NoSuchElementException -
remove()：可选操作，如不支持就抛UnsupportedOperationException；如支持，需确保能安全删除上一次next()返回的元素
推荐用私有内部类实现 Iterator，便于访问容器的私有字段（如数组、size、elements），避免暴露内部结构。
验证是否真正生效
光写完代码还不够，要确认两点：
- 能通过编译：
for (String s : myCustomList) { ... }不报错 - 运行时不崩溃：循环能正确遍历全部元素，不越界、不漏项、不重复
- 支持其他基于
Iterable的操作，比如StreamSupport.stream(myCustomList.spliterator(), false)或myCustomList.forEach(System.out::println)
常见错误避坑
新手常踩的几个坑：
- 在
iterator()中返回匿名类但没维护独立状态（比如用外部变量当游标），导致多次遍历结果异常 - 把迭代器做成单例或静态字段，造成并发遍历时状态混乱
-
hasNext()判断条件写错（如用而非 <code>），引发 <code>ArrayIndexOutOfBoundsException - 忘记在
next()中校验hasNext()结果，空循环时直接越界
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
