JSON 入门：看懂接口返回的数据

刚开始调接口、看日志时，很多人都会被一串带大括号的数据吓住：里面有冒号、引号、方括号，分不清哪部分是名字、哪部分是值。其实这就是 JSON，一种专门用来在不同程序之间传数据的文本格式。它长得像人能读懂的清单，机器也很容易解析，网页、手机应用和服务器之间交换数据，用的大多是它。

先看 JSON 的基本样子。它由键和值成对组成，键一定是带引号的文字，值可以是文字、数字、真假值、空值，也可以再嵌套一个对象或一个列表。对象用大括号包起来，表示一件事物的多个属性；列表用方括号包起来，表示一串同类的东西。比如一个用户对象里可以有名字、年龄和一串爱好，爱好就是列表，列表里每一项又可以是一个简单的值。读 JSON 不用从头背语法，先分清大括号是对象、方括号是列表、冒号左边是键、右边是值，就已经能读懂大半。

新手第一次动手，最好的练习是把一段接口返回的数据先格式化再读。没格式化之前，所有内容挤在一行里，眼睛很容易看花；格式化之后，层级用缩进展开，哪个字段属于哪一层一目了然。浏览器开发者工具的网络面板和很多编辑器都自带格式化功能，拿到数据先格式化，再一层一层往下找：先看最外层有几个键，再看自己要的字段在第几层，最后确认它的值是什么类型。这个顺序比逐字读快得多，也很少会找错。

几个细节值得提前知道。第一，文字值必须用双引号包起来，单引号在严格的 JSON 里是不算数的，复制粘贴时最容易在这里出错。第二，键和值之间用冒号分隔，同一层的每一对之间用逗号分隔，但最后一对后面不能再加逗号，多一个逗号整个数据就可能解析失败。第三，数字不要加引号，加了引号就变成文字了，后面做计算或比较时结果会不一样。第四，空值和空字符串不是一回事：空值表示这个字段确实没有值，空字符串表示值就是一段长度为零的文字，判断逻辑时要分开处理。

写 JSON 时常见的坑，几乎都出在格式上。最常见的是括号不成对：开头写了大括号，结尾忘了关上，或者列表和对象混着关错了顺序。遇到解析报错，先数括号、再查逗号，最后看引号有没有成对出现，往往比怀疑接口本身更快找到原因。第二个坑是把注释写进 JSON 里：很多配置文件允许写注释，但纯 JSON 不允许，多一行注释也会导致解析失败，需要说明的内容要放到字段名或另外的文档里。第三个坑是直接用手拼字符串来生成 JSON，字段里一旦出现引号或换行，拼出来的结果很容易断裂，正确做法是用程序自带的工具把数据转成 JSON，让工具处理转义。

最后给新手三条建议。第一，读数据时先看结构再看内容，先分清对象和列表，再找字段，不要一上来就逐字翻译。第二，改数据时一次只改一个字段，改完立刻验证格式能不能解析通过，改坏了也容易定位。第三，拿到一份陌生的接口数据，先把它格式化、折叠几层、记下关键字段的名字和类型，再去写处理它的代码，有了这张地图，写代码就不再是摸黑走路。JSON 本身并不复杂，它就是一套讲清楚“名字对应什么值”的规矩，把这套规矩看熟，接口返回的数据就不再是一团乱码，而是一份可以直接读懂的清单。