TOML、YAML、JSON 互转

在 TOML、YAML、JSON 三种配置格式之间任意转换,自动识别输入格式。语法错误会指出行号和原因,转换中遇到 TOML 不支持 null 等格式差异时会明确提示,可以选择缩进、按键名排序,日期时间自动处理。

三种格式的差异

JSONYAMLTOML
注释不支持# 注释# 注释
空值nullnull 或 ~不支持,只能省略该键
日期时间只能写成字符串2026-10-23 会被识别为日期原生支持日期、时间、带时区的时间
根节点任意值任意值必须是表(键值对)
多行字符串用 \n| 保留换行、> 折叠换行三引号 """…"""
常见用途package.json、接口数据Docker Compose、Kubernetes、GitHub ActionsCargo.toml、pyproject.toml、Hugo、Netlify
  • 注释会丢失:转换基于数据结构,原文中的注释、空行和键的书写顺序(排序时)不会保留。转换后请把重要的注释手工补回去。
  • YAML 的隐式类型:YAML 中不加引号的 yes、no、on 在旧的 YAML 1.1 中会变成布尔值,08 可能被当作八进制,2026-10-23 会变成日期。本工具按 YAML 1.2 解析,需要保持原样的值请加引号。
  • TOML 的数组:本工具使用的 TOML 库遵循 0.5 规范,同一个数组中的元素类型必须相同(如不能混合数字和字符串);TOML 1.0 已放宽此限制,但部分工具仍不支持,混合数组建议改为字符串。
  • 大整数:超过 2^53 的整数(如雪花 ID)在 JavaScript 中会丢失精度,建议在原文中写成字符串。

只在 JSON 和 YAML 之间转换并需要更多选项请用 JSON 与 YAML 互转,格式化 YAML 请用 YAML 格式化与校验,格式化 JSON 请用 JSON 格式化校验。

TOML、YAML、JSON 互转常见问题

TOML、YAML、JSON 互转怎么使用?

把配置内容粘贴到左侧或打开文件(也可以点示例),工具会自动识别格式;在右侧选择要转换成的格式,结果实时显示;可以选择缩进、按键名排序,转 TOML 时可以删除 null 值;点“结果作为输入”可以继续转换。

TOML 怎么转 JSON?

粘贴 TOML 内容,右侧选择 JSON 即可。

YAML 转 TOML 为什么报错?

常见原因是 YAML 中有 null 值或根节点是数组,TOML 不支持这两种情况。

转换后注释还在吗?

不在,转换基于数据结构,注释需要手工补回。

pyproject.toml 能转成 YAML 吗?

可以,粘贴后选择 YAML 输出。

TOML、YAML、JSON 互转的结果应怎样理解?

注释和空行不会保留;TOML 遵循 0.5 规范,数组元素类型必须相同;超过 2^53 的整数会丢失精度。

输入内容会保存或发给外部服务吗?

配置内容只在浏览器本地转换,不会上传。

没有结果或操作失败时先检查什么?

转 TOML 失败时按提示处理:null 值勾选删除或改为空字符串,根节点是数组时在外面包一层对象;YAML 解析错误时检查缩进是否混用了 Tab。

相关工具

INI 配置文件编辑器 · ISBN 校验与转换 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具