XML 转 JSON 转换器

在浏览器中把 XML 转换为 JSON,无需上传,无需注册。

所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。

深度指南

XML 转 JSON 的映射规则:属性、重复元素与被丢弃的内容

本转换器使用的确切映射:属性用 @,与属性并存的文本用 #text,只有重复名称才变成数组,所有值都是字符串,混合内容的文本、注释和声明会被丢弃。

最后核实: 本指南的纯文本版

关键数字一览

属性
键带 @ 前缀(例如 "@id")
命名空间声明也是属性,所以 xmlns:ns 会显示为 "@xmlns:ns"。
与属性并存的文本
存放在键 "#text" 下
没有属性的叶子元素则直接变成普通字符串。
重复元素
只有同名出现多次才变成数组
一个 <item> 得到对象或字符串,两个则得到数组。
值的类型
始终是字符串
12.50 仍是 "12.50";true 仍是 "true"。

转换如何工作

页面把你的文本(去掉首尾空白)以 application/xml 交给浏览器的 DOMParser。如果浏览器报告解析错误,你只会看到固定的提示“这不是格式良好的 XML。”;具体的行、列和原因不会显示。否则根元素成为唯一的顶层键,每个元素按以下规则变成 JSON 值(已在真实页面上核对):

XML JSON
<a><b>Mei</b></a> {"a":{"b":"Mei"}}
<a/> 或 <a></a> {"a":""}
<price currency="SGD">12.50</price> {"price":{"#text":"12.50","@currency":"SGD"}}
<a x="1"/> {"a":{"#text":"","@x":"1"}}
<a><b>1</b><b>2</b></a> {"a":{"b":["1","2"]}}
<a><b>1</b></a> {"a":{"b":"1"}}
<a><b>1</b><c>x</c><b>2</b></a> {"a":{"b":["1","2"],"c":"x"}}
<ns:a xmlns:ns="urn:x" ns:id="5"/> 键 "ns:a",带 "@xmlns:ns" 和 "@ns:id"

输出用两个空格缩进。所有值都是字符串:转换器从不猜测数字或布尔值,所以 12.50 会保留末尾的零。

示例

<people><person id="1" active="true"><name>Mei</name></person><person id="2"><name>Ali</name></person></people>
{
  "people": {
    "person": [
      { "@id": "1", "@active": "true", "name": "Mei" },
      { "@id": "2", "name": "Ali" }
    ]
  }
}

(页面会把每个对象展开成多行。)如果只有一个 <person>,同一路径下得到的是对象,而不是只有一项的数组。

会丢失什么

  • 混合内容:在 <a>text<b>bold</b>more</a> 中,只保留 {"a":{"b":"bold"}};只要元素有子元素,文本节点 text 和 more 就会被丢弃。
  • 既有子元素又有属性的元素,其文本 同样被丢弃;只保留属性和子元素。
  • 注释和处理指令 被忽略,XML 声明也不会出现在结果中。
  • 不同名称之间的顺序:同级元素按名称分组,所以 b, c, b 变成 b: [..], c,穿插顺序无法恢复。
  • CDATA 会并入普通文本:<![CDATA[1 < 2 & 3]]> 变成字符串 1 < 2 & 3。实体会被解码(&amp;&lt;&#65; 得到 &<A)。
  • 空白:子元素之间的缩进被忽略,但只含文本的元素会保留其空格,所以 <a> </a> 得到 " "。

错误与严格性

XML 比 HTML 严格得多。浏览器会拒绝:多个根元素(<a/><b/>)、标签不匹配(<a><b>1</a>)、属性值没加引号(<a b=1/>)、同一标签上的重复属性、以数字开头的名称(<1/>),以及 XML 规范没有定义的实体,例如 &nbsp;(只有 amp、lt、gt、apos、quot 是预定义的)。不是 XML 的纯文本也会被拒绝。输入为空时输出为空,不报错。

DOCTYPE 内部实体由浏览器解析器处理(测试中 <!DOCTYPE a [<!ENTITY e "hi">]><a>&e;</a> 得到 "hi"),所以含大量 DOCTYPE 的文档,结果取决于浏览器。不要粘贴带 DTD 的不可信 XML 并期待统一行为。

提示: 因为一个子元素得到对象、多个子元素得到数组,使用这份 JSON 的代码必须同时处理两种形态。如果 XML 由你控制,使用一致的包装元素会让 JSON 更易用;否则请在代码中规范化(遇到非数组就包成数组)。

常见错误

  • 把 "@id" 和 "#text" 当成数据本身。它们是本工具的约定;其他转换器可能用 _attributes、$ 或 attr_。
  • 期待得到数字或布尔值:所有值都是文本。
  • 转换含多个顶层元素的 XML 片段;请先用一个根元素包起来。
  • 以为可以无损往返。JSON 转 XML 不写属性,所以 @id 会变成名为 _id 的元素。

相关工具

反方向用 JSON 转 XML,用 JSON 格式化检查或重排结果,用 JSON 查看器浏览,或用 JSON 转 CSV展开记录。

常见问题

我的数据会被上传吗?

不会。转换完全在您的浏览器中通过 JavaScript 运行。您粘贴的内容不会离开您的设备,不会被记录,也不会存储在服务器上。

可以处理多大的文档?

限制取决于您浏览器的内存,而非服务器配额。几兆字节的文档可以顺利转换;极大的文件可能会让页面在处理时短暂无响应。

嵌套数据会怎样处理?

对于没有嵌套概念的格式,嵌套值会以 JSON 字符串的形式存入单元格,因此不会有内容被悄悄丢弃,结构也可以还原。

能正确处理字段中的引号和逗号吗?

可以。解析遵循 RFC 4180,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。

资料来源

  1. W3C — Extensible Markup Language (XML) 1.0, Fifth Edition — Well-formedness rules, root element, attributes, predefined entities, mixed content.
  2. IETF — RFC 8259, The JSON Data Interchange Format — The JSON output.
  3. MDN — DOMParser — The browser parser the converter relies on.

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

相关工具

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。