JSON 编辑器

原地编辑 JSON:格式化、压缩或按键名排序,状态栏实时检查是否有效。

JSON 有效。

所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。

深度指南

安全编辑 JSON:实时重排的工作流程及其限制

JSON 编辑器页面实际是什么(一个输入框加一份实时的、只读的 2 空格缩进副本)、如何用它修复和整理文档,以及它做不到什么。

最后核实: 本指南的纯文本版

关键数字一览

布局
左侧可编辑输入,右侧只读输出
只能在左侧输入框里输入;右侧输出框不能编辑。
输出缩进
固定 2 个空格
如需 4 个空格或制表符,请使用 JSON 格式化页面。
更新时机
输入每次变化时
JSON 无效时输出会被清空,直到文本再次可解析。
数组布局
每项一行
较短的数组也不会保持在同一行。

修复并整理 JSON 文档

页面在每次变化时都会重新解析,所以右侧输出框同时也是有效性指示灯。

  1. 步骤 1: 粘贴文档

    放进左侧输入框,或点“载入示例”从示例开始。

  2. 步骤 2: 就地编辑

    只要文本是有效的 JSON,右侧就会显示重新缩进后的版本。

  3. 步骤 3: 输出变空时修正错误

    红色信息给出浏览器的解释,有行和列时会一并显示。上一次正确的输出不会保留。

  4. 步骤 4: 复制干净的结果

    右侧再次出现内容后点“复制结果”,粘贴到需要的地方。

这个页面是什么

尽管名叫编辑器,它并不是带语法高亮的代码编辑器,而是一对联动的视图:左侧是用来粘贴或输入的纯文本框,右侧是只读副本,每次变化后都会重新解析并以两个空格重新缩进。它的作用是让你立刻看出修改后文档是否仍然有效,有效时可以复制干净的版本。按钮有:复制结果、载入示例和清空。没有下载按钮、没有树形视图,除浏览器自带的撤销外没有历史记录,也不能选择其他缩进。

一切都在本地用 JSON.parse 和 JSON.stringify 完成。

实时重排的工作流程

上面的步骤时间线展示了这个循环。要记住的关键行为:文本一旦不再是有效的 JSON,右侧输出框就会变空,而不是保留上一次的正确输出;在左侧修正报告的位置后,输出会自动恢复。“载入示例”会替换左侧框里的所有内容,如果还想保留自己的文本,请先复制。

示例

间距不规则、含制表符和末尾零的输入:

{"id":7,  "name":"Mei",
	"tags":[ "a","b" ],"addr":{"city":"Singapore","zip":"018956"},"score":4.50,"note":null}

输出(取自真实页面):

{
  "id": 7,
  "name": "Mei",
  "tags": [
    "a",
    "b"
  ],
  "addr": {
    "city": "Singapore",
    "zip": "018956"
  },
  "score": 4.5,
  "note": null
}

删掉输入末尾的 } 后,输出变空,并提示 Expected ',' or '}' after property value in JSON at position 111 (line 2 column 88)。“zip”字符串保留了前导零,因为它是字符串;如果写成不带引号的 018956 就无效了(JSON 数字不允许前导零)。

输出会改变什么

输出是重新序列化的结果,而不是把空格修好的原文。预期:4.50 变成 4.5;é 之类的转义变成 é;重复键只剩最后一个值;整数形式的键移到对象最前面;非常大的整数会损失精度(12345678901234567890 变成 12345678901234567000)。注释和末尾逗号会让文档无效,所以永远不会被保留。较短的数组也一律展开为每项一行,因此输出比手工把 [1, 2, 3] 保持在一行的写法更长。

提示: 把左侧当作工作副本,把右侧当作有效性检查。如果左侧文本已经有效,只是缩进混乱,从右侧复制比手工重新缩进更快。

限制

  • 没有查找替换、行号、折叠或语法着色;大规模重构请用你自己的编辑器。
  • 没有模式(schema)验证。文档可以是有效的 JSON,却仍不符合你的 API。
  • 不会对键排序。如果需要稳定的键顺序来做对比,请先用脚本排序,再用文本对比比较。
  • 唯一的大小限制是浏览器内存,而且每次按键都会重新解析整个文档,所以特别大的输入会觉得卡。

常见错误

  • 去编辑右侧框。它是只读的;修改要在左侧框里做。
  • 以为修正错误期间上一次的有效输出会一直显示。文本无法解析时它会消失。
  • 粘贴 JavaScript 对象或带注释的 JSON,期望被清理;请先修正语法。
  • 忘记输出中的数字和键顺序可能与输入不同。

相关工具

用 JSON 格式化选择 4 个空格或制表符并下载结果,用 JSON 验证器只检查语法,用 JSON 查看器浏览,或用 JSON 压缩工具压缩。

常见问题

JSON 编辑器和格式化工具有什么不同?

编辑器直接改写你正在编辑的文本:“格式化”“压缩”“按键名排序”按钮会修改文档本身,状态栏会显示它是否仍是有效 JSON。

我的 JSON 会被发送到服务器吗?

不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时,这一点尤为重要。

为什么提示我的 JSON 无效?

最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。

它会改动我的数据吗?

不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。

能处理大型文档吗?

可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。

资料来源

  1. IETF — RFC 8259, The JSON Data Interchange Format — What counts as valid JSON text.
  2. MDN — JSON.stringify() — How the output is written back, including the indent argument.

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

相关工具