JSON 格式化工具

用 2 个空格、4 个空格或制表符格式化 JSON 缩进,并可下载结果。

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

深度指南

JSON 格式化:格式化、压缩与验证到底做了什么

格式化工具如何用浏览器的 JSON.parse 解析,哪些内容在往返后会变化(键顺序、大数字、重复键),以及如何读懂错误信息。

最后核实: 资料来源: IETF — RFC 8259 本指南的纯文本版

关键数字一览

解析器
浏览器内置的 JSON.parse,严格遵循 RFC 8259 语法
不接受注释、末尾逗号、单引号和 NaN。
来源: IETF — RFC 8259
缩进选项
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 无效?

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

它会改动我的数据吗?

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

能处理大型文档吗?

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

资料来源

  1. IETF — RFC 8259, The JSON Data Interchange Format — Grammar, number interoperability, duplicate names and member order.
  2. MDN — JSON.stringify() — Indent argument, Infinity and NaN written as null.
  3. ECMAScript language specification — Own-property ordering (integer-like keys first) used when objects are re-serialised.

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

相关工具

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。