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

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

- Tool: [JSON 格式化与压缩工具](https://toolsg.com/zh/json-formatter)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 解析器 | 浏览器内置的 JSON.parse，严格遵循 RFC 8259 语法 — 不接受注释、末尾逗号、单引号和 NaN。 | [IETF — RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.html) |
| 缩进选项 | 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 验证器](https://toolsg.com/zh/json-validator)，压缩用 [JSON 压缩工具](https://toolsg.com/zh/json-minify)，浏览嵌套数据用 [JSON 查看器](https://toolsg.com/zh/json-viewer)，把记录转成表格用 [JSON 转 CSV](https://toolsg.com/zh/json-to-csv)，比较两个版本用[文本对比](https://toolsg.com/zh/text-diff)。

## 常见问题

**如何用 4 个空格或制表符格式化 JSON？**

使用编辑器上方的“缩进”菜单，选择 2 个空格、4 个空格或制表符，输出会立即更新，“下载”会保存为 formatted.json。

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

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

**为什么提示我的 JSON 无效？**

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

**它会改动我的数据吗？**

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

**能处理大型文档吗？**

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


## 资料来源

- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — Grammar, number interoperability, duplicate names and member order.
- [MDN — JSON.stringify()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) — Indent argument, Infinity and NaN written as null.
- [ECMAScript language specification](https://tc39.es/ecma262/) — Own-property ordering (integer-like keys first) used when objects are re-serialised.
