JSON格式化

美化与压缩分别改变什么

一段挤成单行的接口响应，例如 {"user":{"id":7,"roles":["editor","reviewer"]},"active":true}，美化后会按对象和数组层级换行缩进，便于看清字段归属；压缩则重新输出紧凑的单行文本。两种模式都会先解析输入，再把解析结果重新序列化，所以无效语法不会被猜测修复，也不会生成一个看似正常的结果。

压缩移除的是结构符号周围可忽略的空格、换行和制表符，不会删除字符串值内部的空格。例如 {"name":"Ada Lovelace"} 中姓名之间的空格仍会保留。美化适合阅读和评审，压缩适合需要紧凑文本的粘贴、传输或存储场景。

输入能表示哪些值

JSON 值可以是对象、数组、字符串、数字、布尔值或 null，因此顶层内容不必一定是对象：true、42 和 [1,2,3] 都能作为完整输入。对象名称和字符串必须使用双引号；true、false、null 必须小写。单引号字符串、未加引号的键名、注释、尾逗号、NaN 与 Infinity 都不属于这里接受的标准 JSON 语法。

空格、换行、回车和制表符可出现在结构符号前后，但字符串里的换行、引号和反斜杠必须正确转义。页面做的是语法解析与重排，不会根据业务规则检查“年龄是否合理”“某字段是否必填”，也不会按 JSON Schema 验证字段类型。

缩进选项与可复现示例

美化模式可选 2、4 或 8 个空格，也可把缩进类型改成制表符。选择制表符时，每一层使用一个 Tab；空格数量只对空格缩进生效。输入 {"items":[{"sku":"A-01","qty":2}],"paid":false} 并选择 2 个空格，会得到：

{
  "items": [
    {
      "sku": "A-01",
      "qty": 2
    }
  ],
  "paid": false
}

切换到压缩模式，同一结构会输出为 {"items":[{"sku":"A-01","qty":2}],"paid":false}。当前功能不提供按字母排序键名、树形折叠、自动修复或注释保留，键名顺序也不应被当作数据语义。

规范依据与核验范围

合法性说明以 JSON 标准和浏览器通用解析、序列化行为为依据；这些资料解释语法边界、缩进机制与数字精度风险，而不是为具体业务数据背书。

从粘贴到复制或下载

1. 准备完整文本

   从接口响应、日志或配置中复制完整 JSON，不要混入日志级别、时间戳、Markdown 代码围栏或说明文字。也可先点“示例”载入可用样例，观察输入与输出区域的变化。

2. 粘贴并等待输出

   把文本放入输入区后，页面会自动处理，不需要再找“格式化”按钮。输入为空时输出保持为空；语法有效时，右侧会显示美化结果以及字符数、行数。

3. 确定排版方式

   美化模式下选择 2、4、8 个空格或 Tab。缩进变化会自动反映到输出；若目标是单行文本，切换到“压缩”模式，此时缩进选项不参与结果。

4. 核对并取走结果

   先抽查关键字段、数组长度和数字，再使用复制按钮写入剪贴板，或下载名为 formatted.json 的 JSON 文件。“清空”会同时清除当前输入、输出和错误信息。

解析失败时优先检查什么

失败后，输出区会显示解析器返回的错误文字并停止生成结果。错误措辞和位置表达可能随浏览器不同而变化；它能指出解析停止附近的位置，但不会自动给出业务层面的修复方案。可按下面顺序缩小范围：

• 把属性名和字符串的单引号改为英文双引号，并排除中文弯引号。
• 删除对象最后一个成员或数组最后一个元素之后的尾逗号。
• 检查大括号、中括号和双引号是否成对，字符串中的双引号是否写成 \"。
• 移除 //、/* ... */ 注释以及代码围栏；需要保留说明时，可把说明作为普通字符串字段。
• 确认布尔值和空值写成小写的 true、false、null，并把 NaN、Infinity 改成接收方约定的合法表示。

常见疑问

为什么单引号、注释或尾逗号会报错？

因为它们不属于标准 JSON 语法。请使用双引号包围键名和字符串，删除注释，并移除最后一个成员或元素后面的多余逗号；页面不会把这些写法自动转换成合法 JSON。

压缩会删掉字符串里的空格吗？

不会。压缩只消除结构符号周围不影响语法的空白，字符串引号内部的空格、制表符或已转义字符属于数据内容，会按序列化结果保留。

只有对象和数组才能格式化吗？

不是。标准 JSON 允许顶层是任意 JSON 值，所以字符串、数字、布尔值与 null 也能通过解析；这类简单值没有嵌套层级，美化后通常仍只有一行。

为什么没有输出，复制和下载也不可用？

通常是输入为空或解析失败。先查看输出区的错误提示并修正语法；只有成功得到非空结果后，复制和下载操作才有可用内容。

大整数、重复键与敏感文本边界

不要把排版结果当作原文逐字保真副本。 该流程会解析后重新序列化，除缩进外还可能规范化 Unicode 转义、指数写法和对象属性顺序。例如 1e3 可能输出为 1000。

• 大整数：超出浏览器数值安全表示能力的整数可能在解析阶段损失精度。例如实测输入 {"id":9007199254740993} 会输出为 {"id":9007199254740992}。订单号、雪花 ID、银行卡号等不参与运算的长数字，应由数据提供方以字符串传递，取得结果后还要逐项核对。
• 重复键名：RFC 8259 建议对象内名称保持唯一。输入 {"a":1,"a":2} 在当前处理结果中只保留后一个值；因此不要用格式化结果审计含重复键的原始证据。
• 文本规范化：\u4e2d\u6587 可能重新输出为可读的中文字符，数字的字面写法也可能改变。若签名、哈希、法证留档或差异比较依赖原始字节，请保留未经改写的原文件。
• 性能与隐私：格式化与压缩在当前浏览器中完成，不需要把输入正文提交给格式化服务；页面未设定可承诺的文件大小上限，超长或深度嵌套文本仍可能受设备内存和浏览器性能影响。敏感数据还应遵循所属组织的脱敏与设备安全要求。