libxmljs-mt 是基于 libxml2 的 Node.js XML 库，需系统预装 libxml2 开发包，通过 N-API 绑定实现高性能解析、XPath 查询与修改；官方版已停更，推荐使用社区维护的 libxmljs-mt 分支。
libxmljs 是一个基于 libxml2 的 Node.js XML 处理库，提供 DOM 操作、XPath 查询、XML/HTML 解析与序列化等功能。它不是纯 JavaScript 实现，而是通过 Node.js 的 N-API（或旧版 NAN）绑定 libxml2 C 库，因此使用前需确保系统已安装 libxml2 开发头文件和动态库。
安装前提：系统级依赖必须到位
libxmljs 无法仅靠 npm install 完成——它在编译阶段会调用系统 libxml2。不同系统操作不同：
-
Ubuntu/Debian：
sudo apt-get install libxml2-dev -
macOS（Homebrew）：
brew install libxml2，并确保 pkg-config 可找到（必要时设export PKG_CONFIG_PATH="/opt/homebrew/opt/libxml2/lib/pkgconfig"） -
Windows：推荐使用 Windows Subsystem for Linux（WSL），或通过
node-gyp配合 Visual Studio 工具链 + 预编译 libxml2（较复杂，生产环境建议换用xml2js或fast-xml-parser等纯 JS 方案）
安装 libxmljs（注意版本兼容性）
官方维护的 libxmljs 已停止更新（最后发布于 2018 年），当前稳定可用的是社区维护分支 libxmljs-mt（mt = multi-thread safe，修复了内存泄漏和线程安全问题）：
npm install libxmljs-mt
安装过程会触发 node-gyp 编译，自动探测系统 libxml2。若失败，请检查 pkg-config --modversion libxml-2.0 是否返回版本号（如 2.9.14），否则绑定无法进行。
基础用法：解析、查询、修改
以下是最常用操作示例（以解析 XML 字符串为例）：
const libxmljs = require('libxmljs-mt');
const xml = `
Apple Banana `;
// 解析为文档对象
const doc = libxmljs.parseXml(xml);
// XPath 查询所有 item 节点
const items = doc.find('//item');
items.forEach(item => {
console.log('ID:', item.attr('id')?.value());
console.log('Name:', item.get('name').text());
});
// 创建新节点并追加
const newItem = doc.node('item').attr({ id: '3' });
newItem.node('name').text('Cherry');
doc.root().addChild(newItem);
console.log(doc.toString()); // 输出修改后的 XML
常见问题与绕过技巧
由于绑定底层 C 库，运行时易出错：
-
Segmentation fault：多因传入非法字符串（含 \0）、重复释放节点、或跨作用域使用已销毁的 Node 对象。避免长期缓存
doc.find()返回的节点引用，应在同一作用域内完成操作。 -
中文乱码：确保输入 XML 声明编码一致，如
；libxmljs 默认按 UTF-8 处理，不支持 GBK 等编码，需提前转码。 -
替代方案考虑：若仅需简单解析/生成，且无需 XPath 或 DTD 验证，
fast-xml-parser（零依赖、快、支持流）或xml2js（成熟、生态好）更轻量稳健。
