JSON 转 XML 转换器

什么是 JSON 转 XML 转换，它是如何工作的？

// Convert JSON to XML in Node.js using fast-xml-parser
import { XMLBuilder } from 'fast-xml-parser';

const data = {
  catalog: {
    product: {
      '@_id': 'P01',
      '@_category': 'electronics',
      name: 'Wireless Headphones',
      price: {
        '@_currency': 'USD',
        '#text': '79.99'
      }
    }
  }
};

const builder = new XMLBuilder({
  attributeNamePrefix: '@_',   // @_ keys become XML attributes
  textNodeName: '#text',       // #text key becomes element text content
  ignoreAttributes: false,     // process @_ attribute keys
  format: true,                // pretty-print with indentation
  indentBy: '  ',              // 2-space indent
});

const xml = builder.build(data);
console.log(xml);
// <catalog>
//   <product id="P01" category="electronics">
//     <name>Wireless Headphones</name>
//     <price currency="USD">79.99</price>
//   </product>
// </catalog>

核心功能

示例

{"user":{"id":42,"name":"Alice Kim","email":"alice@example.com","role":"admin","address":{"city":"Seoul","country":"KR"}}}

[{"id":1,"name":"Widget A","price":9.99},{"id":2,"name":"Widget B","price":14.99},{"id":3,"name":"Widget C","price":4.49}]

{"catalog":{"product":{"@_id":"P01","@_category":"electronics","name":"Wireless Headphones","price":{"@_currency":"USD","#text":"79.99"}}}}

使用方法

1. 1

   粘贴 JSON 数据

   在上方输入框中输入或粘贴 JSON 数据。也可以点击「加载示例」试用示例 — API 响应对象、数组载荷，或使用 @_ 属性和 #text 的对象。

2. 2

   查看实时 XML 输出

   XML 即时显示在输出面板中。单键对象使用其键作为根元素；多键对象包裹在 中；带 @_ 前缀的键变为属性；数组变为重复子元素。按需调整缩进（2 或 4 空格）。

3. 3

   复制或下载

   点击「复制」将 XML 复制到剪贴板，或点击「下载」将其保存为 .xml 文件。如需验证或重新格式化结果，请将其粘贴到 XML 格式化工具中。

常见转换陷阱

// Input: { "status": 200, "data": { "id": 1 } }
// Output: <root><status>200</status><data><id>1</id></data></root>
// Root is <root> — may not match your schema

// Wrap in a named key to control the root element
// Input: { "response": { "status": 200, "data": { "id": 1 } } }
// Output: <response><status>200</status><data><id>1</id></data></response>

// Input: [{ "id": 1 }, { "id": 2 }]
// Output: <root><item><id>1</id></item><item><id>2</id></item></root>
// Tag names are generic

// Wrap in a named key for meaningful tag names
// Input: { "products": [{ "id": 1 }, { "id": 2 }] }
// Output: <root><products><id>1</id></products><products><id>2</id></products></root>
// Each array element reuses the key name "products" as its tag

// Input: { "tag": { "id": "42", "name": "Alice" } }
// Output: <tag><id>42</id><name>Alice</name></tag>  ← id is a child element

// Use @_ prefix for attributes
// Input: { "tag": { "@_id": "42", "name": "Alice" } }
// Output: <tag id="42"><name>Alice</name></tag>  ← id is an attribute

// Input: { "price": { "@_currency": "USD", "value": "29.99" } }
// Output: <price currency="USD"><value>29.99</value></price>
// Text is a child element, not text content

// Use #text for element text content
// Input: { "price": { "@_currency": "USD", "#text": "29.99" } }
// Output: <price currency="USD">29.99</price>  ← text content

// JSON key starts with digit — invalid XML element name
// Input: { "1stItem": "value" }
// Output: <1stItem>value</1stItem>  ← invalid XML

// Use a valid XML element name
// Input: { "firstItem": "value" }
// Output: <firstItem>value</firstItem>  ← valid XML

// JSON: { "query": "name = 'Alice' & role = 'admin'" }
// Converter outputs: <query>name = 'Alice' &amp; role = 'admin'</query>
// If double-processed: &amp;amp; — consumer is re-escaping

// Converter output is correct — consume it as XML, not as a raw string
// <query>name = 'Alice' &amp; role = 'admin'</query>
// XML parser decodes to: name = 'Alice' & role = 'admin'

常见使用场景

调用 SOAP 和遗留 XML Web 服务

在应用中构建 JSON 载荷，转换为 XML，然后将其 POST 到 SOAP 端点。这避免了手工拼接 XML 字符串，让你可以以原生 JSON 结构处理数据，直到需要为遗留服务序列化的最后一刻。

生成 XML 配置文件

Spring、Maven、Ant、Tomcat 和 Android 都使用 XML 配置格式。以 JSON 生成或转换配置数据（更易于 diff 和版本控制），再转换为 XML 用于部署。

生成 Sitemap 和 RSS Feed XML

内容管理系统和静态网站生成器通常以 JSON 形式存储页面元数据。将该元数据转换为 sitemap.xml 或 RSS Feed XML，提交给搜索引擎或将内容分发到 Feed 阅读器。

企业数据集成（EDI / ERP / CRM）

ERP 系统（SAP、Oracle）、CRM 平台和 EDI 网络通常以 XML 格式交换数据。将现代 REST API 的 JSON 导出转换为 XML，无需构建自定义 XML 序列化器即可对接这些系统。

Android 资源文件

Android 字符串资源、布局约束和 Manifest 条目都是 XML。以编程方式从 JSON 数据源生成或更新资源文件，并转换为 Android 构建系统所需的 XML 格式。

SVG 和矢量图形生成

SVG 是 XML。以 JSON 数据形式构建 SVG 结构 — 路径、形状、颜色、变换 — 然后转换为 XML 以生成适用于 Web、印刷或矢量编辑工具的有效 SVG 文件。

技术细节

符合 RFC 8259 的 JSON 解析

JSON 输入使用浏览器原生的 JSON.parse() 解析，完全符合 RFC 8259 标准。提供准确的语法错误信息（尽力提供位置信息：行号和列号），并处理所有 JSON 数据类型：字符串、数字、布尔值、null、数组和对象。

自定义递归 JSON 转 XML 序列化器

解析后，自定义递归序列化器遍历 JSON 树。以 @_ 开头的对象键作为父元素上的 XML 属性输出。#text 键作为元素的文本内容输出。普通对象键变为子元素。数组值生成重复的同名兄弟元素。文本内容和属性值中的特殊字符（<、>、&、"、'）转义为其 XML 实体引用。

根元素规范化

由于 XML 要求有且仅有一个根元素，序列化器在构建文档前应用根元素规范化：单键对象使用该键作为根；多键对象和顶层数组接收合成的 包装。这确保无论输入形状如何，输出始终是格式良好的 XML。

100% 浏览器端 — 不上传，无服务器

所有处理均在浏览器的 JavaScript 引擎中运行。数据在任何时候都不会通过网络传输。超过 200KB 的输入会自动从实时模式切换到手动模式（需要显式点击「转换」），以保持浏览器响应，防止繁重序列化时主线程阻塞。

最佳实践

使用单键对象控制根元素

生成有意义 XML 最简洁的方式是确保顶层 JSON 是一个单键对象，其键就是所需的根元素名称。将多键数据包裹在一个命名键下，可以得到语义明确的根元素，而非通用的 包装。

对属性密集型 XML 使用 @_ 和 #text

如果目标 XML 模式大量使用属性（配置文件、SVG 和 SOAP 信封中很常见），请在转换前将 JSON 中相应字段改用带 @_ 前缀的键和 #text。生成的 XML 将与目标模式完全匹配，无需后处理。

将数组包裹在命名对象中以获得有意义的标签名

顶层数组生成通用的 ... 模式，其中 是固定字面量名称。将数组包裹在命名键下 — { "products": [...] } — 会生成重复的 元素（键名用于每个数组元素）置于 包装下。这给出了领域相关的标签名，对于需要被模式解析或验证的 XML 几乎总是更好的选择。

使用 XML 格式化工具验证输出

转换后，将 XML 输出粘贴到 XML 格式化工具中，验证格式良好性、检查缩进，并在将 XML 发送给下游服务或提交到版本控制前识别任何结构问题。

转换前净化 JSON 键

XML 元素名称必须以字母或下划线开头，且不得包含空格或大多数特殊字符。如果 JSON 键来自外部来源（数据库列名、API 字段名或用户输入），请在转换前审核其 XML 名称有效性，以避免生成格式不良的输出。

常见问题