JavaScript 生态中的 XML 解析与生成方案对比

在现代 Web 开发中，虽然 JSON 已成为数据交换的主流格式，但 XML 依然在特定领域占据重要地位，如 SOAP 接口、RSS 订阅、Sitemap 协议以及部分企业级遗留系统。fast-xml-parser、xml-js 和 xml2js 是 Node.js 生态中处理 XML 的三个主要库。它们都旨在简化 XML 与 JavaScript 对象之间的转换，但在设计理念、性能表现和 API 风格上存在显著差异。

🚀 解析 API 与使用风格

fast-xml-parser 采用现代类实例化风格，支持同步解析，性能极佳。

• 需要实例化 XMLParser 类。
• 默认配置通常能满足大部分需求，支持高度定制。

// fast-xml-parser: 类实例化同步解析
import { XMLParser } from "fast-xml-parser";
const parser = new XMLParser();
const result = parser.parse(xmlString);

xml2js 是老牌库，早期基于回调，现在支持 Promise。

• 提供 parseString (回调) 和 parseStringPromise (Promise)。
• 配置通过构造函数传入。

// xml2js: 支持 Promise 的解析
import { parseStringPromise } from "xml2js";
const result = await parseStringPromise(xmlString);

xml-js 提供简单的函数式调用，配置灵活。

• 直接调用 xml2js 函数。
• 支持 compact 模式（紧凑）和默认模式（详细）。

// xml-js: 函数式调用
import { xml2js } from "xml-js";
const result = xml2js(xmlString, { compact: false });

🗂️ 数据结构映射：属性与文本处理

这是三个库差异最大的地方，直接影响后续代码如何处理数据。

fast-xml-parser 默认将属性前缀化为 @_，文本内容直接作为值。

• 可以通过 ignoreAttributes: false 保留属性。
• 结构清晰，易于访问。

// fast-xml-parser: 属性带前缀
// <book id="1">Title</book>
// 输出：{ book: { "@_id": "1", "#text": "Title" } } (取决于配置)
const parser = new XMLParser({ ignoreAttributes: false });

xml2js 默认将属性放在 $ 键下，文本内容放在 _ 键下。

• 这种嵌套结构有时显得冗长。
• 需要频繁访问 .$ 和 ._。

// xml2js: 属性在 $ 中
// <book id="1">Title</book>
// 输出：{ book: { $: { id: "1" }, _: "Title" } }
const result = await parseStringPromise(xmlString);

xml-js 默认将属性放在 _attributes 键，文本放在 _text 键（非紧凑模式）。

• 语义化较好，但键名较长。
• 紧凑模式下结构完全不同。

// xml-js: 属性在 _attributes 中
// <book id="1">Title</book>
// 输出：{ elements: [{ attributes: { id: "1" }, text: "Title" }] }
const result = xml2js(xmlString, { compact: false });

🛡️ 验证能力

fast-xml-parser 内置了独立的验证器 XMLValidator。

• 可以在解析前快速检查 XML 合法性。
• 适合处理不可信的外部输入。

// fast-xml-parser: 内置验证
import { XMLValidator } from "fast-xml-parser";
const validation = XMLValidator.validate(xmlString);
if (validation !== true) console.error(validation.err);

xml2js 没有内置验证器。

• 解析失败会直接抛出错误或返回错误回调。
• 依赖 try-catch 处理非法 XML。

// xml2js: 依赖异常捕获
try {
  await parseStringPromise(xmlString);
} catch (err) {
  console.error("Invalid XML", err);
}

xml-js 没有内置验证器。

• 同样依赖异常捕获或检查返回结果。
• 适合信任源数据的场景。

// xml-js: 依赖异常捕获
try {
  xml2js(xmlString);
} catch (err) {
  console.error("Invalid XML", err);
}

🏗️ 生成 XML (JSON to XML)

fast-xml-parser 使用 XMLBuilder 类。

• 配置与解析器类似，保持一致性。
• 性能优秀。

// fast-xml-parser: 构建器
import { XMLBuilder } from "fast-xml-parser";
const builder = new XMLBuilder();
const xmlContent = builder.build(jsonObject);

xml2js 使用 Builder 类。

• 需要单独导入。
• 配置项较多，学习成本稍高。

// xml2js: 构建器
import { Builder } from "xml2js";
const builder = new Builder();
const xmlContent = builder.buildObject(jsonObject);

xml-js 使用 js2xml 函数。

• 与解析函数对称，简单易用。
• 支持紧凑模式输出。

// xml-js: 函数式构建
import { js2xml } from "xml-js";
const xmlContent = js2xml(jsonObject, { compact: false });

📊 核心差异总结

💡 架构师建议

fast-xml-parser 是目前综合表现最好的选择。它的解析速度最快，且内置验证功能对于处理外部输入至关重要。如果你的项目对性能敏感，或者需要处理不可信的 XML 数据，这是首选。

xml2js 适合维护旧项目。许多现有的 Node.js 项目依赖它，其 API 非常稳定。如果没有性能瓶颈，且团队已经熟悉其 $ 和 _ 的数据结构，继续使用它可以减少迁移成本。

xml-js 适合轻量级场景。它在一些构建工具链（如 Cordova 插件配置）中常见。如果你需要简单的 XML 转换且不希望引入较重的依赖，它是一个不错的中间选项。

最终建议：在新项目中，优先选择 fast-xml-parser。它不仅性能优越，而且 API 设计更符合现代 JavaScript 开发习惯，内置的验证功能也能减少潜在的安全风险。