listiterator是java中专为list设计的双向迭代器，支持正向/反向遍历、按索引定位、以及add/set/remove安全修改操作，其所有行为围绕光标位置展开，需遵循调用约束（如set/remove前必须调用next/previous）。
ListIterator 是 Java 中专为双向遍历和安全修改 List 而设计的迭代器，它比普通 Iterator 多出向前遍历、获取索引、添加/替换元素等能力。关键在于它维护一个“光标位置”，所有操作都围绕当前位置展开。
双向遍历：用 hasNext() 和 hasPrevious() 控制方向
ListIterator 既支持从头到尾（正向），也支持从尾到头（反向）。它的光标初始位于第一个元素之前，调用 next() 向前移动并返回下一个元素；调用 previous() 向后移动并返回上一个元素。
- 正向遍历时，先用 hasNext() 判断是否还有元素，再调用 next()
- 反向遍历时，先用 hasPrevious() 判断是否还有前驱元素，再调用 previous()
- 注意：不能在未调用 next() 或 previous() 的情况下直接调用 set() 或 remove()，否则抛 IllegalStateException
安全修改列表：add()、set()、remove() 的使用时机
ListIterator 允许在遍历过程中增删改，但每种操作有明确约束：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- add(E e)：在光标当前位置前插入元素，插入后光标位于新元素之后，不影响后续 next()，但会使下次 previous() 返回新元素
- set(E e)：替换上一次由 next() 或 previous() 返回的元素，必须已调用过取值方法，且不能紧接着 add() 后调用（会抛异常）
- remove()：删除上一次由 next() 或 previous() 返回的元素，同样要求已调用过取值方法，且不能与 add() 或 set() 连续调用
获取当前位置信息：nextIndex() 与 previousIndex()
这两个方法不移动光标，只返回逻辑索引：
- nextIndex() 返回调用 next() 将访问的元素索引（范围是 0 到 size()）
- previousIndex() 返回调用 previous() 将访问的元素索引（范围是 -1 到 size()-1）
- 例如：光标在第一个元素前时，nextIndex() 是 0，previousIndex() 是 -1；光标在最后一个元素后时，nextIndex() 是 size()，previousIndex() 是 size()-1
创建与典型用法示例
只能通过 List 的 listIterator() 方法获取（如 ArrayList、LinkedList 支持），不能直接 new。常用模式如下：
- 正向遍历并修改：list.listIterator() → 循环 hasNext()/next() → 在合适位置调用 set() 或 remove()
- 反向遍历并插入：list.listIterator(list.size())（光标置于末尾）→ 循环 hasPrevious()/previous() → 在需要位置调用 add()
- 混合操作：比如查找某元素后插入新项，可先正向 next() 找到目标，再 add() 插入其后
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
