JSON格式化入门：开发者必备的调试技巧

JSON是什么？

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式。简单说，它就是用文本方式描述结构化数据的一套规则——用花括号 {} 表示对象，方括号 [] 表示数组，键值对用 "key": value 表示。

几乎所有现代Web API都使用JSON作为数据传输格式。无论是前端调接口、后端返回数据、还是配置文件，JSON无处不在。一个典型的JSON长这样：

{
  "user": {
    "name": "张三",
    "age": 28,
    "skills": ["JavaScript", "Python", "Go"]
  },
  "status": "active"
}

为什么需要格式化？

问题在于：服务器返回的JSON几乎都是压缩过的。为了节省带宽，API响应会移除所有换行和缩进，把整个JSON塞成一行。比如上面那段数据，API实际返回的是：

{"user":{"name":"张三","age":28,"skills":["JavaScript","Python","Go"]},"status":"active"}

数据量一多，这种"压缩态"JSON根本没法看——一个嵌套层级深的接口，响应可能上千个字符挤在一行。想确认某个字段是否返回了、值对不对，靠肉眼在混乱的文本里找，效率极低，还容易看错。

格式化的作用就是把这坨压缩JSON重新排版：按层级缩进、换行、高亮语法，让结构一目了然。这是开发调试的基本功。

用5iTool格式化JSON（3步搞定）

不需要装任何软件，打开5iTool的JSON格式化工具就能用。

• 第一步：粘贴JSON。把API返回的压缩JSON（或任意一段JSON文本）复制粘贴到输入框。也可以直接拖拽 .json 文件进来。
• 第二步：自动格式化。工具会即时检测输入内容，自动排版成带缩进的可读结构，并对键名、字符串、数字进行语法高亮。如果JSON有语法错误，会立即标红提示具体位置。
• 第三步：查看与复制。格式化后的结果支持树形折叠展开——点击对象或数组前面的箭头即可收起/展开某一层级，快速定位到关注的数据。确认无误后一键复制结果。

整个过程在浏览器本地完成，不上传服务器，数据不会外泄。

常见JSON错误及解决方法

手动写JSON或接口拼装时，语法错误非常常见。以下是最高频的几种错误，以及对应的排查方法：

1. 多余的逗号（尾逗号）

JSON规范不允许最后一个键值对后面有逗号，这是新手最容易犯的错误：

// ❌ 错误：最后一个属性后面多了逗号
{
  "name": "张三",
  "age": 28,  ← 这里
}

// ✅ 正确
{
  "name": "张三",
  "age": 28
}

2. 引号错误

JSON的键和字符串值必须使用英文双引号，单引号和中文引号都不行：

// ❌ 错误写法
{'name': '张三'}        // 用了单引号
{"name": "张三"}         // 用了中文引号

// ✅ 正确写法
{"name": "张三"}

3. 括号不匹配

花括号 {} 和方括号 [] 必须成对出现且正确嵌套。嵌套层级一深，少一个右括号很难肉眼发现。5iTool的格式化工具会精确报出错误位置和缺失的括号类型。

4. 键名未加引号

JSON的键必须用双引号包裹，不像JavaScript对象可以省略：

// ❌ 错误
{name: "张三"}

// ✅ 正确
{"name": "张三"}

💡 技巧：遇到JSON报错，直接粘贴到5iTool格式化工具里，错误位置和原因会高亮标出，比对着控制台报错猜快得多。

格式化 vs 压缩：什么时候用哪个？

JSON有"展开"和"压缩"两种形态，对应不同场景：

• 格式化（展开）——用于开发和调试。看接口返回了什么、排查字段缺失或类型错误、对比预期数据结构时，需要清晰可读的排版。
• 压缩（Minify）——用于生产环境传输。API响应移除空白字符可以减小30%-50%的体积，节省带宽、加快传输。前端收到后再按需格式化。
• 树形折叠——用于浏览大型JSON。接口返回几百个字段时，逐层折叠只看关心的部分，比全文搜索更直观。

5iTool的JSON工具同时支持格式化和压缩两种模式，一键切换，适合开发全流程使用。

常见问题（FAQ）