VTD-XML是基于内存映射与非解析思想的高性能XML处理库，以64位整数数组直接索引字节位置，不建DOM树、内存低、XPath快，适用于大文件、高频查询及低延迟场景。
Java中VTD-XML是一种基于非解析（non-extractive）和内存映射思想的高性能XML处理库，它不构建DOM树、不产生大量对象，而是用64位整数数组（VTD记录）直接索引XML文本字节位置，因此解析快、内存占用低、XPath支持强。适合处理大XML文件（几十MB到GB级）、高频查询或对延迟敏感的场景。
快速上手：基本解析与节点遍历
VTD-XML不加载整个文档结构，而是“绑定”原始XML字节数组，再通过VTDNav导航。关键步骤是：读入XML → 创建VTDGen → 生成VTD记录 → 构建VTDNav进行遍历。
- 先将XML内容读为byte[]（推荐用Files.readAllBytes或InputStream.readAllBytes），避免String编码转换开销
- VTDGen.enableIgnoredWhiteSpace(true)可跳过空白文本节点，提升遍历效率
- 调用parse()后必须检查返回值：true表示成功；false需查getErrorMessage()
- VTDNav的toElement()支持向上/下/左/右移动，配合getTokenType()和getTokenString()获取元素名或文本
高效XPath查询：比DOM+XPath快5–10倍
VTD-XML内置轻量XPath引擎，编译一次可重复执行，无需预加载整个树。对常见路径如/root/item[@id='123']/name或//price[.>99]响应极快。
基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
- 用AutoPilot声明XPath：ap.declareXPathNameSpace("ns", "http://example.com") 支持带命名空间的查询
- setXPath()后调用evalXPath()返回匹配节点个数；循环中用iterate()逐个获取位置
- 结果是VTD index（long型），直接传给VTDNav.moveToElement()即可定位，无中间对象创建
- 避免在循环内反复compileXPath()，应提前编译并复用AutoPilot实例
增量更新与部分修改（非重写全文件）
VTD-XML支持在不解析全部内容前提下，精准替换某段文本（如修改<status>pending</status>为<status>done</status>），适用于日志补丁、配置热更新等场景。
立即学习“Java免费学习笔记（深入）”；
- 定位目标token后，用XMLModifier.insertAfterElement()或updateToken()写入新内容
- 所有修改暂存在内部buffer，最终调用output()写入OutputStream，原XML字节数组不受影响
- 注意：插入长度变化可能导致后续token偏移，updateToken()仅适用于等长替换；变长操作需用insert/replace组合
- 若需保留原始缩进或注释，启用VTDGen.setDocURL()并确保输入是完整文件流（而非截断字符串）
使用注意事项与避坑提示
VTD-XML强大但有设计约束，误用易引发IndexOutOfBoundsException或逻辑错位。
- XML必须是合法UTF-8或ISO-8859-1编码；其他编码需先转为UTF-8 byte[]再传入
- 不支持DTD校验、外部实体解析（出于安全默认禁用），也不处理XML声明中的standalone="yes"
- VTDNav不可跨线程共享；每个线程应持有独立VTDNav实例（可复用VTDGen/VTDRecord）
- 大文件建议用FileChannel.map()配合ByteBuffer分配，避免堆内存溢出；必要时启用-Xmx和-XX:+UseG1GC
