elementiterator()不支持按名称过滤，仅返回全部子element迭代器；精准提取应使用elements(String)，它语义清晰、性能好且返回匹配的element列表。
Element.elementIterator() 不支持按名称过滤，直接用会漏掉元素
这个方法返回的是全部子 Element 的迭代器，不接受参数，也不识别你想要哪个名字。很多人以为传个字符串进去就能筛，结果编译都过不去——elementIterator() 根本没有重载版本接收 String 参数。
常见错误现象：写成 element.elementIterator("child")，ide 报错 “cannot resolve method”，或者误用 element.elementIterator().next() 硬循环却没做名称判断，导致拿到错误节点。
- 它只遍历所有子
Element，跳过文本、注释、CDATA 等节点 - 返回类型是
Iterator<element></element>，不是java.util.stream.Stream，没法链式过滤 - 如果父元素有 100 个子元素，但只有 3 个叫
"item"，它还是会迭代全部 100 次，你得自己if (e.getName().equals("item"))判断
要拿指定名称的子元素，用 element.elements(String) 最省事
elements() 是 Dom4j 提供的专用方法，语义清晰、性能好、代码短。它内部做了名称匹配和类型过滤，只返回匹配的 Element 列表。
使用场景：解析配置 xml、提取重复结构（如多个 <user></user>）、遍历同类业务标签。
立即学习“Java免费学习笔记（深入）”；
- 返回
List<element></element>，可直接 for-each 或用索引访问 - 名称区分大小写，
element.elements("User")≠element.elements("user") - 如果没找到，返回空
List，不是NULL，不用判空防 NPE - 比手写
elementIterator()+ if 判断快一点，因为底层避免了构造无关对象
示例：
for (Element user : root.elements("user")) { String id = user.attributeValue("id"); String name = user.elementText("name"); }需要边遍历边修改时，elementIterator() 才有意义
如果你要在遍历过程中删除、替换或移动某些子元素，必须用 elementIterator()，因为 elements() 返回的是快照副本，改它不影响原树结构。
性能影响：迭代器是懒加载，内存友好；但你要频繁调用 next() 又反复 getName() 判断，不如先 elements("x") 拿全再处理——除非节点极多且你只处理前几个。
- 安全删除：用迭代器的
remove()方法，别用parent.remove(element)，否则可能ConcurrentModificationException - 不能在
elementIterator()循环里调用add()或set()改变当前 parent 的子节点数，否则行为未定义 - 如果只是读+删，优先用
elements("target").foreach(parent::remove)更直观
注意 Dom4j 版本差异：4.0+ 的 elements() 支持 null 安全和泛型优化
老项目用的是 Dom4j 1.x（比如 1.6.1），elements(String) 返回 List 原始类型，要手动强转；新版本（4.0.0+）返回 List<element></element>，且对 null 入参做了防御（返回空列表而非 NPE）。
兼容性影响：升级前检查是否用了 (Element) list.get(0) 这类强转，新版可以直接用。
- 1.x 中
elements(null)抛NullPointerException - 4.x 中
elements(null)返回空List，更符合直觉 - 若项目锁死在 1.x，建议封装一层工具方法，避免散落各处的判空逻辑
Dom4j 的命名看似直白，但 elementIterator() 和 elements() 的分工其实很明确：一个为“可控遍历”设计，一个为“精准提取”服务。多数时候你真正要的只是后者，别被 Iterator 字样带偏。