xml2js.parsestring() 读不到根节点内容是因为默认将文本存为子节点的 _ 属性，如 alice 解析为 { name: { _: "alice" } }；需配置 explicitchildren: false、mergeattrs: true、trim: true 等选项优化结构。
xml2js.parseString() 为什么读不到根节点内容
因为 xml2js 默认把文本内容当作子节点的 _ 属性，而不是直接挂到节点值上。如果你的 XML 是 <name>Alice</name>，解析后得到的是 { name: { _: "Alice" } }，不是 { name: "Alice" }。
实操建议：
- 初始化时传入
explicitChildren: false和mergeAttrs: true，减少嵌套层级 - 用
ignoreAttrs: false（默认）保留属性，但注意属性名会带$前缀，比如<item id="123"></item>→{ item: { $: { id: "123" } } } - 如果只处理简单 XML，加
trim: true自动清理首尾空格，避免_值里混入换行符
读取本地 XML 文件时 fs.readFile() 报错 ENOENT
常见于路径写错，尤其是没处理好 __dirname 或相对路径。Node.js 的当前工作目录（process.cwd()）不等于文件所在目录，直接写 ./data.xml 很容易找不到。
实操建议：
- 一律用
path.join(__dirname, "data.xml")拼接绝对路径 - 先用
fs.existsSync()检查文件是否存在，别等parseString()报错才反应过来 - 确保文件编码是 UTF-8 —— Windows 记事本另存为时容易选成 GBK，会导致解析出乱码或中断
async/await + xml2js 怎么写才不卡主线程
xml2js 本身是纯同步解析，但 fs.readFile() 是异步的；真正卡住的是解析大文件（几 MB 以上）时的 CPU 占用，不是 I/O。
实操建议：
- 小文件（await fs.readFile() +
parseStringPromise()（需用util.promisify(xml2js.parseString)包一层） - 大文件改用
xml2js.Parser({ async: true })配合流式读取，但要注意：它返回的是Parser实例，得手动监听end事件，不能直接 await - 别在 Express 路由里直接解析几 MB 的 XML 并返回结果 —— 用户等不到响应，Node 进程也容易夯住
解析失败时 error 对象里没有具体行号
xml2js 不提供 XML 语法错误位置信息，报错通常是 Error: Invalid character 或 Unexpected end，但不说在哪一行。调试成本高。
实操建议：
- 先用
xmllint --noout data.xml（需安装 libxml2）验证格式，它会明确提示第几行第几个字符出错 - 在
parseString()的回调里检查err是否为真，别只看result是否为空 - 对用户上传的 XML，务必加 try/catch 并记录原始字符串前 200 字符，否则出错后根本没法复现
XML 解析真正的麻烦不在怎么调用函数，而在边界情况：注释、CDATA、命名空间、自闭合标签、非法字符、BOM 头……这些地方一出问题，错误表现往往和你猜的完全不一样。
