Java中自定义集合支持for-each循环需实现Iterable<T>接口并提供Iterator<T>实例；具体包括：1. 集合类声明实现Iterable<E>并重写iterator()方法返回迭代器；2. 迭代器实现hasNext()、next()和可选remove()，确保状态一致与异常处理。
在 Java 中，让自定义集合类支持 for-each 循环（即增强 for 循环），关键在于实现 Iterable<T> 接口，并提供一个符合规范的迭代器。这需要两步：一是让集合类实现 Iterable<T>，二是返回一个实现了 Iterator<T> 的对象。
实现 Iterable 接口并重写 iterator() 方法
你的自定义集合类（比如 MyList<E>）需声明实现 Iterable<E>，并提供 iterator() 方法，该方法必须返回一个有效的 Iterator<E> 实例：
- 返回的对象可以是内部类、匿名类或单独的迭代器类
- 返回的迭代器必须能正确反映当前集合的状态（如元素增删后的行为）
- 通常建议使用内部类，便于访问集合的私有字段（如数组、size 等）
编写符合规范的 Iterator 实现
Iterator<E> 要求实现三个方法：hasNext()、next() 和可选的 remove()（若不支持删除，抛 UnsupportedOperationException）：
- hasNext()：判断是否还有未遍历的元素，通常基于当前索引与集合大小比较
-
next()：返回下一个元素，并移动内部指针；若已无元素，应抛
NoSuchElementException -
remove()：如果集合允许边遍历边删除，需维护“上次返回位置”逻辑（如用
lastRet记录），否则直接抛异常
一个完整示例（基于动态数组的简单列表）
假设你有一个 MyArrayList<E>，底层用 Object[] 存储：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
public class MyArrayList<E> implements Iterable<E> {
private Object[] elements;
private int size;
// 构造、add、get 等略...
@Override
public Iterator<E> iterator() {
return new MyArrayListIterator();
}
private class MyArrayListIterator implements Iterator<E> {
private int cursor = 0; // 下一个要返回的索引
@Override
public boolean hasNext() {
return cursor < size;
}
@Override
@SuppressWarnings("unchecked")
public E next() {
if (!hasNext()) {
throw new NoSuchElementException();
}
return (E) elements[cursor++];
}
@Override
public void remove() {
throw new UnsupportedOperationException("remove not supported");
}
}
}
这样写好后，就能直接用 for-each：
MyArrayList<String> list = new MyArrayList<>();
list.add("a"); list.add("b");
for (String s : list) {
System.out.println(s); // 输出 a, b
}
注意事项和常见坑
实际开发中容易忽略的点：
- 迭代器应是fail-fast还是fail-safe？Java 集合默认是 fail-fast（检测到并发修改就抛
ConcurrentModificationException），如需支持安全遍历（如遍历中允许其他线程修改），可用快照或复制策略 - 每次调用
iterator()应返回新实例，避免多个 for-each 共享同一迭代状态 - 如果集合支持修改操作（如 add/remove），迭代器中的
remove()方法应与集合状态同步，否则可能引发不一致 - 泛型擦除下注意类型安全：内部存储用
Object[]，取值时强制转换，需确保存入类型一致
