JSON 格式化工具
用 2 个空格、4 个空格或制表符格式化 JSON 缩进,并可下载结果。
所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。
深度指南
JSON 格式化:格式化、压缩与验证到底做了什么
格式化工具如何用浏览器的 JSON.parse 解析,哪些内容在往返后会变化(键顺序、大数字、重复键),以及如何读懂错误信息。
关键数字一览
- 缩进选项
- 2 个空格、4 个空格或制表符
- 压缩时不含任何空白。
- 数字
- 按 IEEE 754 双精度解析
- 超过 9007199254740991 的整数,以及需要超过约 17 位有效数字的小数,可能会改变。
- 下载
- formatted.json
- 文件内容就是输出框里的内容,无论是格式化还是压缩后的结果。
三个按钮的工作方式
页面先用 JSON.parse 解析你的文本,成功后再用 JSON.stringify 写回。所有处理都在浏览器里完成,不会发送到任何地方。
- 格式化:按所选缩进(2 个空格、4 个空格或制表符)输出。
- 压缩:输出时标记之间不留任何空白。
- 验证:只解析并报告“JSON 有效”或错误,不改动输出框。
首尾空白会先被去掉。输入为空时提示“请输入 JSON 数据”。状态提示三秒后消失;编辑输入内容会清空输出,避免旧结果与新文本并排。
由于输出是重新序列化的结果,而不是对原文本的空白编辑,所以得到的是“同一份数据的规范写法”,而不是“只改了空格的原文”。以下情形要特别留意。
往返后可能发生的变化
| 你粘贴的内容 | 输出 | 原因 |
|---|---|---|
{"b":1,"2":"x","1":"y"} |
键依次为 "1"、"2"、"b" |
JavaScript 把整数形式的键排在最前并按升序排列 |
{"a":1,"a":2} |
{"a":2} |
后面的重复键生效;RFC 8259 指出重复键的行为不可预测 |
12345678901234567890 |
12345678901234567000 |
双精度只能保留约 15–17 位有效数字 |
9007199254740993 |
9007199254740992 |
超过 2^53 − 1 后并非每个整数都能表示 |
1.50、1.0、5E+2 |
1.5、1、500 |
数字会被重新输出,而不是保留原文 |
-0 |
0 |
JSON.stringify 把负零写成 0 |
1e400 |
null |
溢出为 Infinity,而 JSON.stringify 将其写成 null |
"é" |
"é" |
转义先被解码,合法时按字符原样写出 |
这些结果由页面所用的同一组 JSON.parse/JSON.stringify 调用实际运行得出。安全的经验法则:字符串、布尔值、null、数组和普通数字的格式化是无损的;但超大 ID、重复键、以及你在意顺序的数字形式键则不是无损的。如果 19 位的 ID 必须保持原样,请在源数据里把它存成字符串。
格式化、压缩与大小
对象 {"name":"Mei","tags":["a","b"],"n":{"x":1,"y":[]},"e":{}} 压缩后为 57 个字符;2 个空格缩进为 102 个字符,4 个空格为 130 个,制表符为 88 个。空数组和空对象仍保持单行 []、{}。根据 RFC 8259,顶层可以是任何 JSON 值:5、"text"、[] 都有效,不过较旧的解析器只接受对象或数组作为顶层。
读懂错误信息
当引擎的错误信息含有 position N 时,工具会把它换算成“第 L 行、第 C 列”,再附上引擎自己的原文。信息来自你的浏览器,所以 Chrome、Firefox、Safari 的措辞不同,有些信息甚至不带位置(例如 [NaN] 只提示出现了意外的 N)。常见原因:
| 输入 | 问题 |
|---|---|
{"a":1,} |
末尾逗号:此处应为双引号括起的属性名 |
{'a':1} |
JSON 不接受单引号 |
[1,2 |
缺少右括号 |
{"a":01} |
不允许前导零 |
{"a":"x⏎y"} |
字符串内有原始换行,应写成 \n |
// note 或 /* */ |
注释不属于 JSON |
[NaN]、Infinity、undefined |
都不是 JSON 值 |
提示: 先修正第一个报告的位置再重新运行。少一个引号常会引出许多后续错误,但只有第一个是真的。
常见错误
- 粘贴 JavaScript 对象字面量(键不加引号、单引号)却期望通过验证。
- 以为格式化会保留原来的键顺序:数字形式的键会移到最前面。
- 压缩含超大数字 ID 的文档后,再与原文逐位比对。
- 把下载文件当成原始文件;它是重新序列化后的输出,文件名固定为
formatted.json。
相关工具
只检查语法用 JSON 验证器,压缩用 JSON 压缩工具,浏览嵌套数据用 JSON 查看器,把记录转成表格用 JSON 转 CSV,比较两个版本用文本对比。
常见问题
如何用 4 个空格或制表符格式化 JSON?
使用编辑器上方的“缩进”菜单,选择 2 个空格、4 个空格或制表符,输出会立即更新,“下载”会保存为 formatted.json。
我的 JSON 会被发送到服务器吗?
不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时,这一点尤为重要。
为什么提示我的 JSON 无效?
最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。
它会改动我的数据吗?
不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。
能处理大型文档吗?
可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。
资料来源
- IETF — RFC 8259, The JSON Data Interchange Format — Grammar, number interoperability, duplicate names and member order.
- MDN — JSON.stringify() — Indent argument, Infinity and NaN written as null.
- ECMAScript language specification — Own-property ordering (integer-like keys first) used when objects are re-serialised.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。
相关工具
把这个工具嵌入你的网站
免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。