互转

开发手册

JSON / YAML / XML 互转

K8s 的 YAML、接口的 JSON、老系统的 XML,同一个项目里三者共存是常态。贴一段进来,选个目标格式就好。

双向互转 属性与文本节点 本地处理

① 粘贴内容

等待输入

② 复制结果


				
等待输入
使用说明

三种格式分别适合什么

JSON 是接口的通用语言,机器友好但别手写;YAML 靠缩进表达层级,写 K8s 清单、CI 配置最舒服;XML 啰嗦,却是老系统、SOAP、Office 文档与 RSS 的底座。三者之间来回搬数据,本来要装一堆命令行工具,现在贴进来就行。

怎么用

  1. 把内容粘到左边,工具会根据首字符自动判断是 JSON、YAML 还是 XML。
  2. 判断错了就在「识别不准时指定」里手动选一个,比如纯文本的 YAML 有时会被认成普通字符串。
  3. 右边切换目标格式,点「复制」或「下载」拿走结果。

XML 与 JSON 的对应关系

  • 属性:转成带前缀的键,默认 @,例如 <a href="x"> 变成 "@href": "x"。
  • 文本:元素既有属性又有子元素时,文字内容放进 #text;只有文字的元素直接变成字符串。
  • 重复元素:同名子元素自动合并成数组,反向输出时数组的每一项生成一个同名标签。
  • 根节点:JSON 转 XML 时,只有一个键且值是对象就把它当作根元素;否则用你填的根节点名包一层。

几个坑

YAML 的锚点与引用在解析时会被展开,输出不再保留 &anchor,语义一致但文件更啰嗦。YAML 里只有日期的值(如 2026-11-13)会原样保留,带时分秒的会转成 ISO 字符串。数字精度超出 JavaScript 能表示的范围时会失真,比如 19 位的雪花 ID,这类字段建议在源码里按字符串处理。

常见问题

转换后数据会丢吗?

JSON 与 YAML 之间是等价映射,不会丢数据。XML 只有一种结构,属性、文本、子元素混在一起,转成 JSON 时属性用 @ 前缀、文本放进 #text 字段,信息同样完整保留,再转回 XML 能还原成原来的样子。

YAML 里的锚点与引用怎么处理?

解析时会展开引用,输出时默认不再生成锚点,也就是把复用内容铺平成独立副本,语义一致但文件会变长。这样导出的 JSON 与 XML 不会出现悬空引用。

数组转成 XML 是什么样子?

数组里的每一项都会生成一个与字段同名的元素,例如 tags 有两个值就输出两个 <tags>。反向解析时同名元素会自动合并成数组,所以来回转换不会改变结构。

支持多文档 YAML 吗?

支持读取,但只会取第一份文档并在提示里说明,因为 JSON 与 XML 都只能表达单个根节点。需要合并多份文档时,可以先把它们拆开分别转换。

内容会上传到服务器吗?

不会。解析与转换都在浏览器里完成,除了首次加载 YAML 解析组件需要联网外,数据本身不会离开本机。涉及配置文件的转换可以放心使用。