ListIterator是Java中专用于List的双向迭代器，支持前后遍历及遍历时安全增删改元素。通过list.listIterator()获取实例，可指定起始索引。使用hasNext()、next()正向遍历，hasPrevious()、previous()反向遍历，需先移动到末尾再反向。提供add(E e)在当前指针前插入，set(E e)替换上一次访问的元素，remove()删除上一次访问的元素。注意：调用set或remove前必须先调用next或previous，否则抛IllegalStateException；add无此限制。适用于需双向操作或边遍历边修改的场景。
ListIterator 是 Java 中用于遍历和修改列表的双向迭代器，相比普通的 Iterator，它支持前后两个方向遍历，并且可以在遍历过程中安全地添加、修改或删除元素。它是 List 接口特有的工具，不能用于 Set 或其他集合类型。
获取 ListIterator 实例
要使用 ListIterator，必须从实现了 List 接口的集合（如 ArrayList、LinkedList）中获取。通过调用 list 的 listIterator() 方法即可获得实例。
import java.util.*;
List<String> list = new ArrayList<>();
list.add("A");
list.add("B");
list.add("C");
ListIterator<String> iterator = list.listIterator();
也可以指定起始位置：ListIterator<string> iterator = list.listIterator(1);</string> 从索引 1 开始遍历。
双向遍历：向前与向后移动
ListIterator 支持从前往后和从后往前遍历。
javascript-typescript-typescript-scaffold
下载
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
-
hasNext()和next()：判断是否存在下一个元素，并返回它，同时指针后移。 -
hasPrevious()和previous()：判断是否存在前一个元素，并返回它，同时指针前移。
while (iterator.hasNext()) {
String element = iterator.next();
System.out.println("正向: " + element);
}
反向遍历示例（需先走到末尾）：
// 先正向走完
while (iterator.hasNext()) {
iterator.next();
}
// 再反向输出
while (iterator.hasPrevious()) {
String element = iterator.previous();
System.out.println("反向: " + element);
}
在遍历中修改列表
ListIterator 允许在不抛出 ConcurrentModificationException 的情况下对列表进行增删改操作。
立即学习“Java免费学习笔记（深入）”；
-
add(E e)：在当前指针位置前插入元素。 -
set(E e)：替换最后一次调用 next() 或 previous() 返回的元素。 -
remove()：删除最后一次调用 next() 或 previous() 返回的元素。
List<Integer> numbers = new ArrayList<>(Arrays.asList(1, 2, 3));
ListIterator<Integer> it = numbers.listIterator();
while (it.hasNext()) {
Integer value = it.next();
if (value == 2) {
it.set(20); // 修改为 20
}
if (value == 3) {
it.add(4); // 在 3 后插入 4
}
}
System.out.println(numbers); // 输出: [1, 20, 3, 4]
注意事项与常见误区
使用 ListIterator 时需要注意以下几点：
- 调用
set()或remove()前必须先调用next()或previous()，否则会抛出 IllegalStateException。 -
add()不受此限制，可在任意位置插入。 - 每次调用
next()或previous()后，set()和remove()都作用于该次返回的元素。 - 多个修改操作之间可以连续执行，但需注意指针位置变化。
基本上就这些。ListIterator 提供了比普通迭代器更灵活的操作能力，特别适合需要双向访问或边遍历边修改的场景。只要注意调用顺序和指针状态，就能安全高效地使用。
