~/tutorials/json-format

JSON 是什么？接口返回的 JSON 怎么格式化、校验、搜索

2026-09-25 · 约 2 分钟读完

接口一调，返回一大坨 {"code":0,"data":{...}}，既不知道哪行写错了，也不知道值在哪个层级——这是开发联调和看接口文档时最常见的两难。下面用 30 秒讲清 JSON 是什么，再给你三步读一份接口返回的方法，全程浏览器本地完成，不上传、不注册。

JSON 是什么：一段 30 秒讲清

JSON（JavaScript Object Notation）就是一种轻量的数据文本格式：纯文本、键值对组织、几乎人人能读。它只有两种结构——对象（花括号 {}，键值对）和数组（方括号 []，按位置排），再加上字符串、数字、true/false、null 这几种值，够了。

{
  "user": {
    "name": "yvfng",
    "vip": true,
    "tags": ["frontend", "indie-dev"]
  },
  "page": 1,
  "remark": null
}

上面这份里："user" 是键，它右边的 {} 是对象（嵌套了 name、vip、tags 三个键值）；"tags" 的右边是数组；"page" 是数字；"remark" 是 null。记住一句话：JSON 就是「键值 + 两种容器」，没有别的。

把接口返回的 JSON 原样粘进工具，点「美化」。一坨单行文本会变成带缩进的树状结构，每层是什么、嵌套多深，一眼看穿。

接口返回读不下去时，先点「校验」。语法有错（多逗号、单引号、漏括号）时工具会标出行号，你对着行号就能定位是哪个字符写歪了，不用肉眼扫全文。

两份 JSON 长得差不多、怀疑有出入？先各点一次「键排序」，再点「压缩」，剩下的差异就是真差异——用下面的文本对比工具逐行找出来。

工具：yvfng.com 的 JSON 格式化，美化、压缩、校验、键排序，粘贴即用，全程在浏览器本地跑，不上传、不注册。

美化会加上缩进、换行和空格，是给人读的，所以体积变大很正常；发请求、存文件时用「压缩」模式去掉所有空白，体积比原文还小。

对象用花括号 {}，值按「键」组织，键可以重复出现的是键，不是位置；数组用方括号 []，值按位置排，同一份数据可以出现多次。

先点「美化」把 JSON 展开成多行，再用浏览器 Ctrl+F 搜键名或值；一坨单行 JSON 里搜，命中后根本看不出在哪个层级。

合法。JSON 规范里键名是任意 Unicode 字符串，中文键完全没问题；但部分老解析器或下游系统对非 ASCII 键不友好，跨系统传输时建议用拼音或英文键。