Node.js如何解析XML xml2js库使用方法

星降 2026-01-07 00:00:00 次阅读

Node.js需借助xml2js库实现XML与JS对象互转：解析时通过Parser配置ignoreAttrs、attrkey等选项优化结构，推荐使用parseStringPromise；序列化用Builder控制headless和pretty格式。

Node.js 本身不内置 XML 解析能力，常用 xml2js 库将 XML 字符串转为 JavaScript 对象（反序列化），也支持将对象转回 XML（序列化）。它轻量、灵活，适合大多数常规 XML 处理场景。

安装 xml2js

在项目根目录下运行：

npm install xml2js

基础解析：XML 字符串 → JS 对象

默认情况下，xml2js 会把 XML 转成嵌套的 JS 对象，但属性和文本内容需手动区分。推荐启用常用选项提升可读性：

ignoreAttrs: false —— 保留属性（默认忽略）
attrkey: '$' —— 属性存入 $ 字段（如 → { $: { id: "123" } }）
charsAsItems: true —— 文本内容统一用 _ 字段表示（避免与子元素名冲突）
explicitArray: false —— 单个子元素不强制包装成数组（更符合直觉）

示例代码：

const xml2js = require('xml2js');

const xml = `
  
    Alice
    30
  
`;

const parser = new xml2js.Parser({
  ignoreAttrs: false,
  attrkey: '$',
  charsAsItems: true,
  explicitArray: false
});

parser.parseString(xml, (err, result) => {
  if (err) throw err;
  console.log(result);
  // 输出：{ root: { user: { $: { id: "1001", role: "admin" }, name: { _: "Alice" }, age: { _: "30" } } } }
});

简化访问：使用 parseStringPromise（推荐）

v0.5+ 支持 Promise API，避免回调嵌套：

const { parseStringPromise } = require('xml2js');

async function parseXML(xmlStr) {
  try {
    const result = await parseStringPromise(xmlStr, {
      ignoreAttrs: false,
      attrkey: '$',
      charsAsItems: true,
      explicitArray: false
    });
    return result;
  } catch (err) {
    throw new Error('XML 解析失败：' + err.message);
  }
}

// 使用
parseXML(xml).then(console.log);

生成 XML：JS 对象 → XML 字符串

用 Builder 类反向构造：

const { Builder } = require('xml2js');

const obj = {
  root: {
    user: {
      $: { id: "1001", role: "admin" },
      name: { _: "Alice" },
      age: { _: "30" }
    }
  }
};

const builder = new Builder({ headless: true, renderOpts: { pretty: true } });
const xml = builder.buildObject(obj);
console.log(xml);
// 输出格式化 XML 字符串