在NPM项目中使用fast-xml-parser需先安装并按需配置类型支持；解析时需显式启用属性和文本处理，构建XML可自定义缩进与声明；注意UTF-8编码、命名空间支持限制、大文件应选流式库，并用validate预检格式。
在 NPM 项目中使用 XML 库（如 fast-xml-parser）非常直接，核心是安装、导入、解析或构建 XML，并注意编码与选项配置。
安装 fast-xml-parser
在项目根目录下运行：
- npm install fast-xml-parser（推荐 v4+，API 更稳定）
- 若需类型支持（TypeScript），额外安装：npm install --save-dev @types/fast-xml-parser
基本解析：XML 字符串 → JavaScript 对象
适用于读取配置、API 响应等常见场景。注意默认不保留属性和文本混合结构，需显式启用。
- 简单解析（无属性、纯结构）：
const { parse } = require('fast-xml-parser');
const obj = parse(xmlString); - 带属性和文本内容的完整解析：
const parser = new XMLParser({
ignoreAttributes: false,
parseAttributeValue: true,
trimValues: true,
allowBooleanAttributes: true
});
const result = parser.parse(xmlString);
反向操作：JavaScript 对象 → XML 字符串
用 XMLBuilder 可将对象序列化为格式良好的 XML。
- 基础用法：
const { XMLBuilder } = require('fast-xml-parser');
const builder = new XMLBuilder();
const xmlString = builder.build(jsObject); - 自定义缩进、声明、属性写法：
const builder = new XMLBuilder({
ignoreAttributes: false,
suppressBooleanAttributes: false,
indentBy: ' ',
format: true,
ignoreDeclaration: false
});
注意事项与常见问题
XML 处理容易踩坑，尤其涉及编码、命名空间和特殊字符。
-
编码问题：确保输入 XML 是 UTF-8 编码；Node.js 默认处理 UTF-8，但读取文件时建议显式指定：
fs.readFileSync('data.xml', 'utf8') - 命名空间：v4 默认不解析命名空间；如需支持，启用 parseTagValue: true 并配合 removeNSPrefix: false
- 大文件：fast-xml-parser 是内存加载型，不适用于超大 XML（>100MB）；此时考虑流式库如 sax 或 libxmljs
- 验证与错误处理：调用 parser.validate(xml) 可提前检查格式合法性，避免解析崩溃
