转换器

XML 转 JSON

将 XML 数据转换为 JSON 格式

输入 XML
JSON 结果

什么是 XML 转 JSON?

XML(eXtensible Markup Language)和 JSON(JavaScript Object Notation)都是常用的数据交换格式。XML 转 JSON 工具可以将 XML 数据结构转换为 JSON 格式,保留属性和文本内容,方便在不同系统间进行数据格式转换。

功能特点

  • 格式转换:将 XML 数据转换为标准的 JSON 格式
  • 属性保留:正确保留 XML 元素的属性信息
  • 文本内容:保留 XML 元素的文本内容
  • 嵌套处理:正确处理 XML 的嵌套结构
  • 实时转换:输入即时得到转换结果
  • 快速复制:一键复制转换后的 JSON 结果

使用场景

  • API 集成:将 XML API 响应转换为 JSON 格式
  • 数据迁移:在不同系统间迁移数据格式
  • 配置文件:将 XML 配置转换为 JSON 配置
  • 数据交换:满足需要 JSON 格式的系统要求

本工具用 fast-xml-parser 解析 XML 文本并输出带缩进的 JSON:元素成为键、属性加上 @_ 前缀、同名兄弟节点收进数组。适合把 SOAP 或 RSS 响应、Android 清单文件和旧系统的 XML 配置导出整理成能直接在 JavaScript 里读取的对象。

同一个元素会有三种形状

值的形状由上下文决定,与 schema 无关。只含文本的元素直接塌缩成标量,<customer>Ada</customer> 得到 "customer": "Ada";一旦带上属性或子元素,值就变成对象,属性键加 @_ 前缀,散落的文本收进 #text,而这个键只在元素同时还有子节点或属性时才出现。对象里的顺序固定为:子元素、#text、属性,所以 @_ 开头的那几行总在末尾。同名兄弟元素合并成数组,只出现一次则不合并;空元素变成 ""。混合内容会丢掉行内顺序:<p>Hello <b>world</b>!</p> 解析成 {"b": "world", "#text": "Hello!"},两段文本被拼在一起,中间的子元素位置再也还原不出来。

数字被推断,写法被改写

组件开启了 parseAttributeValue,parseTagValue 保持默认开启,因此属性值和文本节点都会经过 strnum 判断。像数字的一律变成 JS number:qty="2" 得到 2,99.50 得到 99.5,0x1F 得到 31,1e5 得到 100000,小写 true 得到布尔值。前导零随类型一起消失:code="007" 变成 7,邮编 01234 变成 1234,补零的发票号、物料编码因此被静默改坏。20 位长整数会保留为字符串,但 2^53 附近并不一致:9007199254740991 和 9007199254740992 是数字,-9007199254740993 仍是字符串。工具栏没有关闭推断的开关,需要原样字符串时只能在 JSON 侧补回类型。

它只解析,不做校验

组件调用的是 XMLParser 而不是 XMLValidator,外面只包了一层 try/catch,所以那条红色报错很少出现。标签不配对时,<a><b></a> 返回 {"a":{"b":""}} 而不报错;文本里裸露的 & 被原样收下;以数字开头的标签名同样能当键用。真正会抛出异常的只有残缺的处理指令,报错文字是 Pi Tag is not closed。这意味着:被截断的 RSS、只复制了一半的配置文件,都会转出一个结构看着正常、值却是空串的对象,所以信任这份 JSON 之前先用校验器核对原文。另外 XML 声明不会被丢掉,<?xml version="1.0"?> 会变成 ?xml 键、版本号还是数字 1;注释则整段消失。

实操示例

带属性、重复明细与补零值的订单

输入
<order id="A-1007">
  <customer>Ada</customer>
  <total currency="USD">99.50</total>
  <line qty="2">Widget</line>
  <line qty="1">Gizmo</line>
</order>
输出
{
  "order": {
    "customer": "Ada",
    "total": {
      "#text": 99.5,
      "@_currency": "USD"
    },
    "line": [
      {
        "#text": "Widget",
        "@_qty": 2
      },
      {
        "#text": "Gizmo",
        "@_qty": 1
      }
    ],
    "@_id": "A-1007"
  }
}

两个 line 被合并成数组,customer 只出现一次所以保持裸字符串。total 同时有文本和属性,是唯一产生 #text 键的元素,属性写成排在子节点之后的 @_currency。像数字的值都被改写:99.50 掉了末尾的零,qty="2" 成了数字 2,而 A-1007 不是数字,保持字符串。默认 2 空格缩进下整份结果是 278 个字符,改成 4 空格则是 374 个。

边界与常见误用

  • 注释被直接丢弃,CDATA 被拆成普通文本,写在这两处的说明或原始片段都不会保留。
  • XML 声明会变成顶层 ?xml 键(版本号是数字),遍历键的代码会因此多出一项,用之前记得删掉。
  • 只出现一次给字符串或对象、重复出现才给数组,同一份 schema 的两次响应可能转出两种 JSON 类型,取值前先归一化。
  • 数字推断没有界面开关,补零编码和 0.10 这类小数写法都会被改写成数值,原始格式无法从输出恢复。
  • 组件不设输入体积上限,也没有 Worker,每次键入都在主线程里整体重解析并重新 stringify,几 MB 的导出文件会让编辑区卡死。

相关工具

出问题时先看这里

输出的 JSON 比粘进去的 XML 还长,一半是 @_ 开头的行

原因每个属性都会变成一个带 @_ 前缀的独立键,对象又是一行一个属性打印的,于是 <line qty="2"/> 这 15 个字符要占三行:"line": {、"@_qty": 2、}。页面自带的示例也一样:211 字节的 XML 在 2 空格下变成 275 字节、19 行,4 空格是 365 字节。

处理把缩进从 4 调回 2——工具栏只有这两档,没有压缩选项——再把复制出来的内容拿到页面外用 jq -c . 压成一行。如果目的本来就是一份小文件,就别过这个页面,直接把 XML 交给 yq -p xml -o json -I0。

转完 SOAP 响应,data.Envelope 是 undefined

原因组件没有设置 removeNSPrefix,带前缀的标签名连冒号一起保存:根键就是 "soap:Envelope",正文是 "soap:Body",命名空间声明则成了 @_xmlns:soap。属性名里有冒号,点语法永远够不到。

处理先用方括号取(data['soap:Envelope']['soap:Body']),在取值处统一去掉前缀;或者换到脚本里跑同一个解析器,加上 removeNSPrefix: true,前缀和 @_xmlns 会一起被去掉。

标题里那些 &nbsp; 转完还是原样的几个字符

原因只展开 XML 自带的五个实体。&nbsp;、&mdash; 这类命名实体、以及任何靠 DTD 声明的实体都原样留在文本里,因为解析器根本不加载 DTD:<c>&nbsp;</c> 出来就是 "c": "&nbsp;"。文本里裸露的 & 同样被悄悄收下。

处理转换完再统一解码剩下的命名实体,别在 JSON 里逐个手改:站内的 HTML 实体工具,或者 python3 -c "import html,sys;print(html.unescape(sys.stdin.read()))" 扫一遍复制出来的结果。

还在敲输入,右边的结果整块消失,红条一闪一闪

原因输出是一个 computed,每次按键都会重新解析整份文档再 stringify,而且它顺手把错误信息写进了响应式状态。任何一个还没敲完的片段都会让这一次按键抛错,结果区就被红条顶掉,直到某次按键能解析通过。

处理尽量整份粘贴;非要在页面里改,就先把当前标签的闭合补完再动下一个位置。只要有一次按键解析成功,红条会自己消失,不用清空重来。

从老 GBK 文件里粘过来的中文全是问号,可输出里 @_encoding 还写着 GBK

原因页面拿到的已经是 JavaScript 字符串,encoding 声明只会作为 @_encoding 属性跟着进 JSON,从来不用来解码任何字节。真正把字节解错的是文本进输入框之前的那一步——打开文件的编辑器,或者把文件打印到屏幕上的终端。

处理先把文件转成 UTF-8 再粘:iconv -f GBK -t UTF-8 config.xml。这样输出里剩下的 @_encoding 只是文件自己的声明,可以直接忽略。

把 XML 变成 JSON 的六种走法,以及什么时候该离开这个粘贴框

你要办的事本页(XML 转 JSON)这种情况该换什么
同一个转换明天还要对着一份新响应再跑一遍输入框是唯一入口:页面不发请求、不存草稿、也不记住上一份文档,明天那份还得重新打开标签页粘进来。缩进只有 2 和 4 两档,也没有压缩输出之类的按钮。写成脚本里的一行——curl -s https://api.example.com/orders.xml | yq -p xml -o json——步骤可重复、结果能 diff,请求还留在命令历史里。要做第二遍,就该搬过去。
金额、发票号、邮编必须一个字不改地落进 JSON属性值走 parseAttributeValue,文本节点走默认开启的 parseTagValue,于是 <price>12.00</price> 变成 12、补零编号 0042 变成 42,工具栏里没有能关掉它的控件。python 的 xmltodict 把每个叶子都当字符串返回,fast-xml-parser 设成 parseTagValue: false 也是同样效果。要拿去对账、要当 join key 的数据,就该走这两条路——这里改写掉的值收不回来。
几千行的文档里只想要某一个分支两个面板永远渲染整棵树:没有路径输入框,没有过滤,没有搜索。最宽的那个节点有多宽,你就得横向滚多远。用 XPath 把那一小段单独取出来——xmllint --xpath "//line[@qty>1]/@id" feed.xml 或 xmlstarlet sel -t -v "//line/@id"——先收窄范围,再决定要不要把这段贴进来按缩进看。
这份文件以后还要转回 XML,注释和 CDATA 都不能丢注释被丢弃,CDATA 被拆成普通文本,所以 XML → JSON → XML 走一圈,这两种结构都消失了,混合内容里的行内顺序也再拼不回来。把 XML 留在唯一真源的位置,用 XSLT(xsltproc)做变换;或者在脚本里用 commentPropName、cdataPropName 把它们保留下来。本页适合看清结构,不适合当无损中转站。
XML 是 SOAP 信封,或者任何带命名空间前缀的东西前缀原样留在键名里:根键就是 "soap:Envelope",正文在 "soap:Body" 下,声明则变成 @_xmlns:soap,于是 data.Envelope 是 undefined,点语法一个都取不到。要么改成方括号取值(data['soap:Envelope']['soap:Body']),要么用脚本跑同一套解析器并加上 removeNSPrefix: true,前缀连同 @_xmlns 那几条一起消失。
其实你最后要的是 XML,不是 JSON本页只有单向。站内的「JSON 转 XML」认得这边输出的 @_ 与 #text 约定,能把属性还原成属性,但它总会多套一层元素(默认 root,除非你改名),缩进也固定是 2 空格。只要一份能用的临时副本,直接用「JSON 转 XML」走完这一趟就行;要能长期进 diff、要留住声明和注释的,就以原文件为模板生成 XML,XSLT 或模板文件才保得住这些东西。

常见问题

XML 的属性转成 JSON 后去哪了?
本工具采用广泛使用的约定:属性放入以 @ 开头的键( → {"@id":"1"}),文本内容放在 #text 键。不同库的默认约定不同,对接前先确认目标系统期待哪种映射。
为什么转换后数据类型全变成了字符串?
XML 只有文本,没有数字/布尔类型概念。除非开启类型推断(把 "123" 识别为数字),否则一切按字符串转换。对接强类型 API 时注意补类型。
带命名空间的 XML 转换后键名很长?
工具保留完整限定名( → "ns:item"),这是无损做法。想去掉前缀可在转换后做键名清理,但注意不同前缀可能指向同一命名空间,直接合并有歧义风险。

内容复核: