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

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

- Tool: [JSON 编辑器](https://toolsg.com/zh/json-editor)
- 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.

## 关键数字一览

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

## 修复并整理 JSON 文档

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

1. **粘贴文档** — 放进左侧输入框，或点“载入示例”从示例开始。
2. **就地编辑** — 只要文本是有效的 JSON，右侧就会显示重新缩进后的版本。
3. **输出变空时修正错误** — 红色信息给出浏览器的解释，有行和列时会一并显示。上一次正确的输出不会保留。 相关工具: [JSON 校验器](https://toolsg.com/zh/json-validator)
4. **复制干净的结果** — 右侧再次出现内容后点“复制结果”，粘贴到需要的地方。

## 这个页面是什么

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

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

## 实时重排的工作流程

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

## 示例

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

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

输出（取自真实页面）：

```json
{
  "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。
- 不会对键排序。如果需要稳定的键顺序来做对比，请先用脚本排序，再用[文本对比](https://toolsg.com/zh/text-diff)比较。
- 唯一的大小限制是浏览器内存，而且每次按键都会重新解析整个文档，所以特别大的输入会觉得卡。

## 常见错误

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

## 相关工具

用 [JSON 格式化](https://toolsg.com/zh/json-formatter)选择 4 个空格或制表符并下载结果，用 [JSON 验证器](https://toolsg.com/zh/json-validator)只检查语法，用 [JSON 查看器](https://toolsg.com/zh/json-viewer)浏览，或用 [JSON 压缩工具](https://toolsg.com/zh/json-minify)压缩。

## 常见问题

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

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

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

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

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

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

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

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

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

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


## 资料来源

- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — What counts as valid JSON text.
- [MDN — JSON.stringify()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) — How the output is written back, including the indent argument.
