JSON 数组和对象怎么写:结构与嵌套入门
结论:把 JSON 仅有的两种容器一次讲清:对象管字段、数组管列表,嵌套怎么组合、什么时候用哪个,以及数字键伪数组、尾逗号、单引号三类高频错误的修法。

JSON 只给你两种容器:对象负责「有名字的字段」,数组负责「按顺序排列的列表」——写不对的九成问题出在引号、逗号,以及把列表写成了伪对象。
一、JSON 只有两种容器
不管接口返回的数据有多复杂,拆到最后只有两种容器和六种值。对象(object)是一组「键值对」,用花括号 {} 包起来;数组(array)是一串按顺序排列的值,用方括号 [] 包起来。值可以是字符串、数字、true/false、null,也可以再嵌套对象或数组——对象套数组、数组套对象,就这样组合出所有真实数据。
{
"user": { "name": "Ada", "active": true },
"roles": ["admin", "editor"],
"lastLogin": null,
"loginCount": 42
}
这个认知很实用:遇到看不懂的 JSON,不要从第一个字符往下读,先找最外层是 { 还是 [。是对象,就按字段理解;是数组,就按列表理解,再逐层往里拆。json.org 的语法图一共只有一页,原因正是如此:两种结构加上递归嵌套,表达能力就够用了。
二、对象的写法:四条硬规则
对象是新手出错最密集的地方,规则其实只有四条:
- 键必须是双引号字符串。
{name: "Ada"}、{'name': 'Ada'}都不合法,必须是{"name": "Ada"}。JavaScript 对象字面量允许裸键和单引号,但 JSON 不允许——这是两者最常见的混淆点。 - 键值对之间用逗号分隔,最后一个后面不能有逗号。
{"a": 1, "b": 2,}会在右花括号处报Unexpected token }。 - 键应当唯一。RFC 8259 用的是 SHOULD 而不是 MUST,重复键不报错,但取第一个还是最后一个由解析器决定,不同语言结果可能不同,不能依赖。
- 键的顺序没有语义。
{"a":1,"b":2}和{"b":2,"a":1}是同一个对象,diff 工具和比较函数都会忽略键序;需要顺序的数据应该放进数组。
三、数组的写法:顺序本身是数据
数组按位置存值,索引从 0 开始:["admin", "editor"] 里 "editor" 是 [1]。「顺序有意义」是数组和对象最本质的差别——搜索结果按相关度排序、操作日志按时间排序,这些信息只存在于顺序里,换成对象就丢了。
两个实用建议:一是数组元素尽量同构,[{"id":1},{"id":2}] 远比 [1, "text", true] 好处理,后者合法但每一步消费代码都要做类型分支;二是空数组 [] 是完全合法的值,字段暂时没有内容时用 [] 而不是 null,消费者就不用先判断有没有、再判断是不是空。
[
{ "city": "Tokyo", "population": 13960000 },
{ "city": "Delhi", "population": 16780000 }
]
四、嵌套:真实接口的四种形状
真实数据都是两种容器互相嵌套,模式基本就四种:
| 形状 | 长相 | 典型场景 |
|---|---|---|
| 对象套数组 | {"tags": ["a","b"]} |
实体的列表字段 |
| 数组套对象 | [{"id":1},{"id":2}] |
记录列表、分页结果 |
| 对象套对象 | {"db": {"host": "..."}} |
分组配置、地址信息 |
| 数组套数组 | [[1,2],[3,4]] |
矩阵、表格行 |
典型的 API 响应通常是「对象做外壳、数组做内容」:
{
"code": 0,
"data": {
"items": [
{ "id": 1, "title": "first" },
{ "id": 2, "title": "second" }
],
"page": 1,
"total": 2
}
}
嵌套别为了深而深:三四层以后,取值路径长得没法读,消费端代码也跟着膨胀。总是同时出现的字段应该收进一个子对象,比如把 addrCity、addrZip 换成 address: {city, zip}。
五、用对象还是数组:一张决策表
| 问题 | 答案 | 原因 |
|---|---|---|
| 每个值都有名字吗 | 对象 | 靠键取值,增删字段不破坏结构 |
| 是一串同类记录吗 | 数组 | 顺序有意义,可以 map/filter |
| 要按键快速查找吗 | 键做索引的对象 | O(1) 直取,不用遍历 |
| 是同一个实体的几项属性 | 对象 | 属性之间没有顺序 |
| 是会增删的同质条目 | 数组 | 长度自由伸缩 |
特别要提一个反模式:用 "0"、"1"、"2" 这种连续数字键的对象冒充数组。它不报错,但丢掉了数组的长度语义和遍历方法,消费端要额外把 Object.keys 排序再取值。键如果是连续编号,直接写成数组。反过来,「键值对列表」(如 [{"key":"theme","value":"dark"}])也不如对象 {"theme": "dark"},除非键本身动态、没法预先声明。
六、三类高频错误与报错对照
| 错误写法 | 典型报错 | 修法 |
|---|---|---|
尾逗号 {"a":1,} |
Unexpected token } |
删掉最后一个逗号 |
单引号/裸键 {name:'Ada'} |
Unexpected token ' / Expected property name |
键和字符串一律双引号 |
Python 字面量 True/None |
Unexpected token T |
改成 true/null |
| 数字键伪数组 | 不报错,语义错 | 改成真数组 |
两个定位技巧:解析器报错的位置通常在错误字符之后,看到 position 42 要往回看一两个字符;单行大 JSON 建议先用格式化工具换行再定位,行列号比字符偏移直观得多。完整的报错反查可以看JSON 报错信息反查表,逐条排查流程在JSON 解析报错怎么修。
七、写完之后:把结构核一遍
手写的 JSON 一定要过一遍解析器再交付。最轻量的验证是命令行:
python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK
在线侧把内容粘进 JSON 解析格式化 页,语法错误会给出行列级定位;切到树形视图能直观看到每一层的类型——数字有没有被当成字符串、数组长度对不对,一眼可见。如果要给业务方看,数组套对象的结构可以直接在 JSON 转表格 页展开成行列,顺带验证「这份数据是不是规整的记录列表」。
结构层面的疑问(哪个字段该是数组、嵌套深了怎么重构)属于类型建模,进阶内容见六种类型、数字精度与编码陷阱。
JSON 数组和对象可以互相转换吗?
可以但不对等。对象转数组通常意味着把键变成值(丢失按键查找的便利),数组转对象要给每个元素造一个键(键的来源就是新问题)。转换前先想清楚消费端怎么用,别只做语法搬运。
对象的键可以重复吗?
语法上允许,RFC 8259 只是「应当」唯一。但 JavaScript 取最后一个值、部分 C 族库取第一个,行为不一致;签名、diff、哈希场景重复键会直接造成结果分歧。生成侧应避免,消费侧遇到未知来源的数据要按不可信输入处理。
数组里可以放不同类型的值吗?
语法允许,[1, "a", true] 是合法 JSON。但异构数组意味着消费端每个位置都要做类型判断,Schema 也很难表达。除了矩阵、元组这类位置即语义的场景,尽量让数组保持同构。
为什么 {name:'json'} 校验不过?
因为 JSON 规定键和字符串值都必须用双引号。{name:'json'} 是 JavaScript 对象字面量,不是 JSON。改成 {"name": "json"} 就能过校验;需要单引号、裸键、注释的写法属于 JSON5/JSONC 方言,要用对应解析器而不是标准 JSON.parse。