转换器

JSON 转 XML

将 JSON 数据转换为 XML 格式

输入 JSON
XML 结果

什么是 JSON 转 XML?

JSON(JavaScript Object Notation)和 XML(eXtensible Markup Language)都是常用的数据交换格式。JSON 转 XML 工具可以将 JSON 数据结构转换为 XML 格式,支持自定义根节点名称,方便在不同系统间进行数据格式转换。

功能特点

  • 格式转换:将 JSON 数据转换为标准的 XML 格式
  • 自定义根节点:支持自定义 XML 根节点名称
  • 属性处理:正确处理 JSON 对象的属性转换
  • 数组处理:将 JSON 数组转换为 XML 元素列表
  • 实时转换:输入即时得到转换结果
  • 快速复制:一键复制转换后的 XML 结果

使用场景

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

把 JSON 文档重写成 XML:对象键成为元素名,带 @_ 前缀的键成为属性,#text 成为元素文本,最后整体再包一层自定义名称的根元素。适合为只接受 XML 的旧系统、SOAP 服务或用 XSD 校验的接口单向生成报文。

属性与文本分别从哪个键来

构建器按 attributeNamePrefix: "@_"、textNodeName: "#text"、ignoreAttributes: false 三个参数工作,这套命名与 fast-xml-parser 解析 XML 时产出的结构一致,所以只有写成该形状的键才会变成属性:{"book":{"@_id":1,"#text":"Dune"}} 得到 <book id="1">Dune</book>,而普通的 id 键只能变成子元素——这正是「明明写了 id 却多出一层标签」的由来。根元素是手工拼接的字符串,顶层对象上的属性与文本无处落脚:{"@_id":"7","#text":"x"} 只剩 <root>x</root>。同一对象里既有 #text 又有普通键时,文本被排在子元素之前,而不是包住它们。

数组只留下重复的兄弟元素

XML 没有数组类型,构建器把同名元素重复输出:{"features":["a","b"]} 得到两个并列的 <features>,外面不套容器。长度只由重复次数体现,因此单元素数组与标量完全同形:["admin"] 与 "admin" 都只产出一个 <roles>admin</roles>,接收方无从分辨。嵌套数组会退化成位置名,[[1,2]] 变成 <m><0>1</0><1>2</1></m>,而标签名不许以数字开头,这段片段会被任何合规解析器判为非法。空数组不产生任何元素,字段静默消失;顶层直接是数组时,同样展开成 <0>、<1> 这样的兄弟节点。

输出在哪些地方已经不是合法 XML

JSON 的键被原样写成标签名,不做任何清洗:my key 含空格、1st 以数字开头,任一条就破坏良构性;a:b 里的冒号会被当成命名空间前缀,而本工具从不写 xmlns 声明,解析器会报前缀未绑定。属性值同样不经加工,布尔值会输出成 <p x></p>——属性名后既没有等号也没有值,这在 XML 里是非法的。文本中的 &、<、> 与属性里的引号会被转义,但不生成 XML 声明、CDATA 段或命名空间。数字按 JavaScript 数值处理:{"id":9007199254740993} 输出为 9007199254740992,1e21 输出为 1e+21,后者对 xsd:double 合法、对 xsd:decimal 非法。另外,format: true 配两格缩进会往树里写入大量纯空白文本节点,比对数据时应比较解析后去掉首尾空白的结果,而不是原始字符串。

实操示例

带一个属性和一个双元素数组的订单对象

输入
{"order":{"@_id":"A-1001","items":["cable","hub"],"total":19.9,"paid":true}}
输出
<root><order id="A-1001">
  <items>cable</items>
  <items>hub</items>
  <total>19.9</total>
  <paid>true</paid>
</order>
</root>

@_ 前缀让 id 变成属性,两个数组元素则变成同名的 items 兄弟节点,没有列表容器。19.9 和 true 都只是文本,XML 本身不带类型,除非另加 xsi:type。根元素是事后拼接的,所以 <root> 与第一个子元素挤在同一行,构建器末尾的换行落在 </root> 之前。

边界与常见误用

  • 不生成 XML 声明、编码属性、命名空间声明和 CDATA 段;需要 <?xml version="1.0" encoding="UTF-8"?> 或带前缀 schema 的对接方,必须复制后手工补上。
  • 键名与根节点名都原样写入、不做校验:my key、1st 或把根节点写成 my root,结果都会被合规解析器拒绝;根节点为空白字符时会静默回退成 root。
  • 数字按 JavaScript 双精度浮点处理:超过 2^53 的整数会丢末尾几位,1e+21 这类指数形式也会原样写出,因此长整型 ID 应以 JSON 字符串传入。
  • 空数组不产生任何元素,字段直接从结果里消失;null 写成 <a/>、空字符串写成 <b></b>,两者解析后都是空内容,事后无法区分。
  • 转换在每次输入时同步执行,组件没有输入长度上限,粘入数兆字节的 JSON 会让输入卡顿;大文档建议在脚本里批量转换。

相关工具

六种接收方,六种「帮我转一下」——哪些本页办得了,哪些办不了

你面对的是哪种接收方本页(JSON 转 XML)这种情况该换什么
对方的 XSD 把标识写成元素上的属性属性不会自己出现:键名原样搬进标签,普通的 id 键永远只能变成子元素,只有带 @_ 前缀(构建器就是这样配置的)的键才会落到开始标签里,变成 id="A-1001"。先看 schema,再改 JSON:40 条记录里把一个字段从子元素挪到属性,输出少了 320 字节、40 行。但值本身是数组的键千万别加前缀——那会输出一个名为 <@_x> 的元素,而 @ 不是合法的名称字符。schema 改不动、源 JSON 也不归你管时,改用模板生成。
同一份导出,下周还要再转一次没有文件选择器、没有 URL 输入、也没有下载按钮——结果区只有一个复制操作,工具栏里唯一的设置是根节点名,而它每次打开页面都从 root 开始,所以「每周一次」意味着每周重新粘贴、重新输入。在 Node 里围绕同一个 fast-xml-parser 的 XMLBuilder 写十来行,把根节点名和 indentBy 固定进脚本,步骤就能重复、结果也能 diff。只要这件事是定期的而不是一次性的,就该搬过去。
XML 必须压成一行,或者要按 2 空格以外的缩进交出去构建器固定跑在 format: true 与 indentBy: " " 上:没有缩进档位,也没有压缩开关,哪怕对方要的就是一整行,复制出来也是排好版的。把结果贴进站内 XML 格式化工具,它能按 1、2、4 空格重排,也有压缩面板;放进构建流程就用 xmllint --noblanks,或同一个构建器设 format: false。前面那 40 条样本正是从 4,493 字节压到 4,053 字节。
交出去之前必须先确定这份 XML 良构本页从不回头解析自己的输出:键名里带空格、布尔值变成 <p x> 这种空属性、嵌套数组生成 <0>,都会原样进复制按钮,而任何合规解析器都不接受这些文本。拿解析器回读一遍:xmllint --noout out.xml,或者丢进站内 XML 格式化工具——它会把面板里的内容真正解析一次,不合格就红字报错。只要这份文件要交给一个你看不到日志的系统,就先做这一步。
接口会校验类型,布尔和小数必须保持类型每个叶子出去都是文本:true、19.9、"19.9" 在输出里长得一模一样,给键加上 @_ 也不会带来类型。工具里没有 xsi:type,也没有能绑定它的 xmlns:xsi。要类型就让模板写出来——xsi:type="xsd:boolean" 连同命名空间声明一起——或者干脆按 schema 要求的字符串发过去,让接收端自己转。本页留给「只要人能读懂」的报文。
粘进去的 JSON 解析不过,而这一批长到没法对半删出错时整个结果区被浏览器自己的 JSON.parse 报错顶掉:报的是相对粘贴字符串的偏移量,新一点的引擎还会附上行列号,可输入区本身毫无标记——光标不跳、字符不选中,四十条记录里照样得从头往下数。jq . shipments.json 直接报出问题所在的行与列,改一次就能重跑一次、不用重新粘贴;站内 JSON 格式化工具也会把同样的报错放在可滚动的输入副本旁边。先在那边把语法修好,再回来粘这一趟。

一个具体场景

属性还是子元素:40 条发货记录背后那 320 字节

一份 40 条记录的发货清单,压成单行 JSON 是 2,854 字节。把标识字段写成 @_code 粘进来,输出 4,493 字节、201 行,每多一条记录就多 112 字节、5 行。把这一个字段改回普通的 code 键,同一批数据变成 4,813 字节、241 行——多出的 320 字节和 40 行,是子元素自己那对开始/结束标签加一行缩进换来的。可见 @_ 是照 schema 做的取舍,不是省字节的技巧;值本身是数组的键,一定别加前缀。真要压体积,把缩进交给 XML 格式化工具的压缩面板去删,不要靠删字段凑数。

常见问题

JSON 的数组转成 XML 后长什么样?
XML 没有数组概念,工具把数组元素映射为重复的子元素(……)。注意双向转换不是 100% 无损的:键名如果恰好构成"数组包装",往返后结构可能变化,设计接口时留意。
JSON 的键含非法 XML 字符怎么办?
XML 标签名不能以数字开头、不能含空格等字符。本工具按原样写出键名,不做占位替换:出现此类键时产物表面完整,但严格解析器会直接判定非法。键名不可控时,应在接口设计层修正,而不是靠转换补救。
转换后的 XML 怎么加命名空间或根节点?
工具可指定根节点名;特定命名空间(SOAP、企业 XSD)通常在转换后补 namespace 声明即可——命名空间声明不影响元素结构本身。

内容复核: