JSON 编辑器
原地编辑 JSON:格式化、压缩或按键名排序,状态栏实时检查是否有效。
JSON 有效。
所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。
深度指南
安全编辑 JSON:实时重排的工作流程及其限制
JSON 编辑器页面实际是什么(一个输入框加一份实时的、只读的 2 空格缩进副本)、如何用它修复和整理文档,以及它做不到什么。
关键数字一览
- 布局
- 左侧可编辑输入,右侧只读输出
- 只能在左侧输入框里输入;右侧输出框不能编辑。
- 输出缩进
- 固定 2 个空格
- 如需 4 个空格或制表符,请使用 JSON 格式化页面。
- 更新时机
- 输入每次变化时
- JSON 无效时输出会被清空,直到文本再次可解析。
- 数组布局
- 每项一行
- 较短的数组也不会保持在同一行。
修复并整理 JSON 文档
页面在每次变化时都会重新解析,所以右侧输出框同时也是有效性指示灯。
-
步骤 1: 粘贴文档
放进左侧输入框,或点“载入示例”从示例开始。
-
步骤 2: 就地编辑
只要文本是有效的 JSON,右侧就会显示重新缩进后的版本。
-
步骤 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 无效?
最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。
它会改动我的数据吗?
不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。
能处理大型文档吗?
可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。
资料来源
- IETF — RFC 8259, The JSON Data Interchange Format — What counts as valid JSON text.
- MDN — JSON.stringify() — How the output is written back, including the indent argument.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。