DOM4J支持Visitor模式实现解耦、可控的XML节点遍历；需实现Visitor接口（或继承VisitorSupport），重写visit(Element/Attribute/Text等)方法，调用accept()启动深度优先遍历，并注意避免在visit中修改节点结构。
DOM4J 本身不强制要求用 Visitor 模式，但它提供了 Visitor 接口和 accept(Visitor) 方法，支持你以 Visitor 模式**手动、可控、解耦地遍历 XML 节点树**——这比递归遍历更灵活，尤其适合需要统一处理多种节点类型（Element、Attribute、Text 等）或做语义分析的场景。
1. 实现 Visitor 接口，覆盖关键 visit 方法
你需要自定义一个类实现 org.dom4j.Visitor 接口，并选择性重写对应方法。常用的是：
-
visit(Element element)：处理元素节点（最常用） -
visit(Attribute attr)：处理属性 -
visit(Text text)：处理文本内容（注意：空格/换行也可能生成 Text 节点） -
visit(Comment comment)：处理注释（可选）
不需要的方法可以空实现，或继承 VisitorSupport（DOM4J 提供的默认空实现类），只重写关心的几个。
2. 调用 accept() 启动遍历
拿到 Document 或任意节点（如 root 元素）后，直接调用 .accept(yourVisitor) 即可。DOM4J 会自动按深度优先顺序递归访问所有子节点（包括 Element、Attribute、Text、CDATA、Comment 等），并分发到对应 visit 方法。
立即学习“Java免费学习笔记（深入）”；
例如：
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
Document doc = DocumentHelper.parseText("<root><user id='123'>Tom</user></root>");
Element root = doc.getRootElement();
root.accept(new MyVisitor()); // 自动遍历整个子树
3. 注意 Attribute 和 Text 的“归属关系”
Attribute 不是 Element 的子节点，但 DOM4J 仍会在遍历 Element 时，**先调用 visit(Element)，再依次调用其所有 Attribute 的 visit(Attribute)**；Text 节点同理，属于 Element 的内容，但会作为独立节点被 visit(Text) 处理。
所以如果你只想处理“有实际内容的元素”，可在 visit(Element) 中检查：element.nodeCount() == 0 && element.getTextTrim().isEmpty() 来跳过空元素。
4. 避免在 visit 中修改节点结构
Visitor 是用于“读取”和“分析”的，不是用于修改的。如果在 visit(Element) 里调用 element.remove() 或 element.add(...)，可能引发 ConcurrentModificationException 或遍历跳过节点——因为底层遍历用的是迭代器。
如需修改，推荐两步走：
- 第一遍 Visitor 收集要修改的目标节点（如 List
targets） - 第二遍单独遍历 targets 执行修改操作
基本上就这些。Visitor 模式在 DOM4J 里不算高频用法，但当你需要清晰分离“遍历逻辑”和“处理逻辑”，或者统一审计/日志/校验多种节点类型时，它比裸写递归更干净、更易维护。
