JSON 入门：从一对花括号读懂数据的通用语言

如果你在浏览器里按 F12 看过网络请求，或者打开过任何一个配置文件，很可能早就见过 JSON。它看起来就是一对花括号、几对引号和冒号，却成了今天前后端、服务之间最常见的数据交换格式。本文用最短的篇幅，把它的结构、类型、常见写法和容易踩的坑讲清楚。

一、JSON 是什么

JSON 的全称是 JavaScript Object Notation，直译是 JavaScript 对象表示法。但不要被名字误导：它现在只是一种与语言无关的文本格式，几乎所有主流语言都能解析和生成。你可以把它理解成一份写给机器读、也方便人阅读的数据清单。

二、只有两种结构

JSON 的结构非常简单，只有对象和数组两种。对象用花括号表示，里面是一组键值对；数组用方括号表示，里面是一组有序的值。对象和数组可以互相嵌套，于是就能表达很复杂的数据。

示例：

{

  "name": "小云",

  "age": 18,

  "tags": ["云计算", "入门"],

  "vip": true,

  "address": null

}

在这个例子里，name 是字符串，age 是数字，tags 是数组，vip 是布尔值，address 是空值。键必须用双引号括起来，这是 JSON 最容易被新手忽略的一点：单引号在 JSON 里是不合法的。

三、六种值类型

JSON 的值只有六种：字符串、数字、布尔值 true 或 false、空值 null、对象和数组。没有日期类型，也没有注释。需要表示时间时，通常用字符串，例如 2026-10-27；需要说明含义时，只能靠键名本身写清楚，或者放在文档里，而不是在 JSON 里写注释。

四、写 JSON 时最常见的三个错误

第一，最后一项后面多了一个逗号。JSON 不允许尾随逗号，最后一项不能加逗号。第二，键没有用双引号，或者用了单引号。第三，字符串里没有转义引号和换行。如果字符串本身包含双引号，要写成反斜杠加引号；换行要写成反斜杠加 n。遇到解析报错时，先检查这三点，往往就能定位问题。

五、JSON 和 JavaScript 对象有什么区别

两者长得很像，但并不等同。JavaScript 对象可以有单引号键、尾随逗号、函数和 undefined，而 JSON 都不允许。反过来说，合法的 JSON 基本可以被 JavaScript 解析，但合法的 JavaScript 对象不一定是合法的 JSON。把数据存成文件、发给接口时，一定要按 JSON 的规则来写。

六、什么时候适合用 JSON

当数据结构清晰、需要跨语言、跨服务传递时，JSON 是很好的默认选择。它可读性好、解析库成熟、调试方便。但它也有边界：不适合存二进制数据，不适合表达非常复杂的引用关系，也不适合做需要注释的配置说明。遇到这些场景，可以考虑用专门的格式，或者在 JSON 外面再加一层说明。

小结

记住三句话就够了：对象是花括号加键值对，数组是方括号加有序值；值只有六种类型；键要用双引号，最后一项不能多逗号。掌握这些，你就能读懂绝大多数接口返回和配置文件，剩下的只是在实践中慢慢熟悉嵌套和字段设计。