JSON 经常出现在接口返回、配置文件、埋点数据和前后端联调中。内容短的时候直接看还行,一旦字段变多、嵌套变深,压成一行的 JSON 就很难阅读,这时就需要先格式化,再校验结构是否正确。

JSON 格式化适合做什么

格式化不会改变字段和值,只会把一行 JSON 按层级缩进、换行,让对象、数组和嵌套关系更清楚。它适合用在接口调试、日志排查、配置整理和复制第三方数据后的快速检查。

需要马上处理内容时,可以打开 JSON 格式化工具,粘贴 JSON 后点击格式化或压缩。

基本使用步骤

  1. 复制需要处理的 JSON 内容,粘贴到输入框。
  2. 点击“格式化 JSON”,查看缩进后的结构。
  3. 如果页面提示解析错误,先按错误位置检查符号、引号和逗号。
  4. 如果要放入请求参数、环境变量或配置项,可以再使用压缩功能转成单行。

格式化前后示例

一行 JSON 不方便阅读:

{"name":"maowenben","tools":["json","base64"],"enabled":true}

格式化后层级更清楚:

{
  "name": "maowenben",
  "tools": [
    "json",
    "base64"
  ],
  "enabled": true
}

常见错误怎么排查

JSON 校验失败时,通常不是字段含义的问题,而是语法不符合 JSON 规则。可以优先检查下面几类情况。

  • 属性名没有使用双引号,例如写成 {name: "test"}
  • 字符串使用了单引号,JSON 标准要求字符串使用双引号。
  • 对象或数组末尾多了逗号,例如 {"a": 1,}
  • 括号没有成对出现,常见于复制嵌套对象时少复制了结尾。
  • 字符串中包含换行、反斜杠等特殊字符,但没有正确转义。

什么时候用压缩

压缩会去掉多余空格和换行,把 JSON 转成单行。它适合放入接口参数、表单字段、环境变量或某些只接受单行内容的配置位置。如果只是阅读和排查问题,优先使用格式化。

如果只需要把 JSON 压成单行,也可以使用 JSON 压缩工具

JSON 和 CSV 怎么互转

当 JSON 是对象数组,并且每个对象结构接近时,可以转换成 CSV 表格文本,方便导入表格软件或给非开发同事查看。对应场景可以使用 JSON 与 CSV 转换工具