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

在Node.js项目里处理XML格式数据时，xml2js是一个轻量且易用的解析库，它可以将XML字符串或文件转换为JavaScript对象，大幅降低XML数据的处理难度。下面详细介绍它的具体使用方法。

xml2js库的安装

首先需要在项目中安装xml2js依赖，打开终端进入项目目录，执行以下命令：

npm install xml2js

安装完成后，就可以在代码中引入该库进行XML解析操作了。

基础解析用法

异步解析XML字符串

xml2js默认提供异步解析方法，适合处理常规XML数据，示例代码如下：

// 引入xml2js库
const { parseString } = require('xml2js');
// 待解析的XML字符串
const xmlData = `<user>
  <name>张三</name>
  <age>25</age>
  <hobby>编程</hobby>
</user>`;

// 调用异步解析方法
parseString(xmlData, (err, result) => {
  if (err) {
    console.error('解析失败:', err);
    return;
  }
  // 输出解析后的JavaScript对象
  console.log(result);
  // 访问具体字段
  console.log('用户名:', result.user.name[0]);
  console.log('年龄:', result.user.age[0]);
});

上述代码中，解析结果是一个嵌套的JavaScript对象，XML的标签会作为对象的属性，标签内的文本内容会放在对应属性的数组里。

同步解析XML字符串

如果需要同步解析场景，可以使用Parser类的parseStringSync方法，示例如下：

const { Parser } = require('xml2js');
const xmlData = `<book>
  <title>Node.js实战</title>
  <price>59.9</price>
</book>`;

const parser = new Parser();
try {
  const result = parser.parseStringSync(xmlData);
  console.log('同步解析结果:', result);
  console.log('书名:', result.book.title[0]);
} catch (err) {
  console.error('同步解析失败:', err);
}

解析XML文件

实际开发中经常需要解析本地XML文件，结合Node.js的fs模块即可实现，代码如下：

const fs = require('fs');
const { parseString } = require('xml2js');

// 读取XML文件内容
fs.readFile('./data.xml', 'utf8', (err, data) => {
  if (err) {
    console.error('读取文件失败:', err);
    return;
  }
  // 解析文件内容
  parseString(data, (parseErr, result) => {
    if (parseErr) {
      console.error('解析XML失败:', parseErr);
      return;
    }
    console.log('文件解析结果:', result);
  });
});

进阶配置用法

自定义解析规则

xml2js支持自定义解析配置，比如设置是否忽略属性、是否合并相同子节点等，示例如下：

const { parseString } = require('xml2js');
const xmlData = `<product id="1001">
  <name>鼠标</name>
  <price>89.9</price>
</product>`;

// 自定义解析配置
const options = {
  // 保留XML标签的属性
  explicitArray: false,
  // 忽略命名空间
  ignoreAttrs: false
};

parseString(xmlData, options, (err, result) => {
  if (err) {
    console.error(err);
    return;
  }
  console.log('自定义解析结果:', result);
  // 访问XML属性
  console.log('产品ID:', result.product.$.id);
  console.log('产品名称:', result.product.name);
});

上述配置中，explicitArray设为false后，单个子节点不会放在数组里，ignoreAttrs设为false可以保留XML标签的属性，属性会放在$对象中。

处理复杂嵌套XML

对于多层嵌套的XML数据，xml2js同样可以正确解析，示例如下：

const { parseString } = require('xml2js');
const complexXml = `<school>
  <class grade="三年级">
    <student>
      <name>李四</name>
      <score>95</score>
    </student>
    <student>
      <name>王五</name>
      <score>88</score>
    </student>
  </class>
</school>`;

parseString(complexXml, { explicitArray: false }, (err, result) => {
  if (err) {
    console.error(err);
    return;
  }
  const classInfo = result.school.class;
  console.log('年级:', classInfo.$.grade);
  classInfo.student.forEach((stu, index) => {
    console.log(`学生${index + 1}姓名:`, stu.name);
    console.log(`学生${index + 1}分数:`, stu.score);
  });
});

常见错误与解决

• XML格式错误：如果XML字符串存在标签未闭合、特殊字符未转义等问题，解析会报错，需要提前校验XML格式的正确性。
• 依赖未安装：如果引入xml2js时报错找不到模块，需要检查是否执行了安装命令，以及项目目录是否正确。
• 字段访问错误：默认解析后子节点是数组形式，直接访问会返回undefined，需要根据解析配置调整访问方式。

使用xml2js解析XML时，建议先打印完整的解析结果对象，确认数据结构后再编写字段访问逻辑，避免不必要的错误。

Node.jsxml2jsXML解析JavaScript修改时间：2026-07-06 15:15:29