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。实体会被解码(&<A得到&<A)。 - 空白:子元素之间的缩进被忽略,但只含文本的元素会保留其空格,所以
<a> </a>得到" "。
错误与严格性
XML 比 HTML 严格得多。浏览器会拒绝:多个根元素(<a/><b/>)、标签不匹配(<a><b>1</a>)、属性值没加引号(<a b=1/>)、同一标签上的重复属性、以数字开头的名称(<1/>),以及 XML 规范没有定义的实体,例如 (只有 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,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。
资料来源
- W3C — Extensible Markup Language (XML) 1.0, Fifth Edition — Well-formedness rules, root element, attributes, predefined entities, mixed content.
- IETF — RFC 8259, The JSON Data Interchange Format — The JSON output.
- MDN — DOMParser — The browser parser the converter relies on.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。
相关工具
把这个工具嵌入你的网站
免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。