xml::twig 通过流式解析与局部构建高效处理大型 xml 文件，支持 twig_handlers 按需处理元素、start/end_tag_handlers 事件驱动解析及 purge/flush 主动内存管理。
XML::Twig 是 Perl 中处理 XML 的成熟模块，特别适合处理**大型 XML 文件**——它不把整个文档加载进内存，而是采用“流式解析 + 局部构建”的策略。关键在于：**只在需要时加载和保留部分树结构，其余内容可即时处理、丢弃或写入外部文件。**
用 twig_handlers 按需处理特定元素
这是最常用、最高效的方式。你为关心的元素（如
- 设置 twig_handlers 哈希，键为 XPath 表达式（如 '/root/data/item'），值为子程序引用
- 在回调中处理数据（提取字段、存数据库、生成日志等），然后调用 $twig->purge 或 $t->flush 主动释放当前 twig 占用的内存
- 避免在回调里长期持有对 $t 或子元素的强引用，否则会阻止自动清理
用 start_tag_handlers 和 end_tag_handlers 实现超低内存解析
当连一个完整元素树都不想保留在内存中（比如只统计标签数量、提取纯文本、做简单校验），可用更底层的事件驱动方式：
-
start_tag_handlers 在开始标签（如
）出现时触发，可获取属性、位置信息 - end_tag_handlers 在结束标签（如 ）出现时触发，可累计文本内容或关闭状态
- 全程无 DOM 树构建，内存占用恒定（通常几百 KB 级），适合 GB 级日志类 XML
配合 flush 和 purge 控制内存峰值
即使用了 twig_handlers，若处理逻辑慢或缓存了大量数据，内存仍可能上涨。主动管理是关键：
- $twig->purge：清空当前 twig 中所有已解析但未被引用的节点（推荐在每个 twig_handler 结尾调用）
- $twig->flush：将已处理的 XML 内容（如原始字节）输出到文件或句柄，同时释放对应内存（常用于转换场景）
- 设置 keep_encoding => 0 和 keep_spaces => 0 可减少额外开销
避免常见陷阱
很多性能问题其实源于误用：
- 不要在 twig_handler 中调用 $t->root 或遍历整个树——这会强制加载并保留全部结构
- 别用 twig_roots 保留多个顶层元素，除非真需要交叉对比；优先用 twig_handlers
- 大文件建议关闭 safe_print（默认开启），避免额外转义检查开销
- 解析前用 XML::Parser 的 ErrorContext 检查编码声明是否匹配实际内容，防止解析中断
