JSON 工具箱

JSON 数组和对象怎么写:结构与嵌套入门

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

入门约 6 分钟发布于 2026-11-20更新于 2026-11-20
JSON 数组与对象结构入门封面

JSON 只给你两种容器:对象负责「有名字的字段」,数组负责「按顺序排列的列表」——写不对的九成问题出在引号、逗号,以及把列表写成了伪对象。

一、JSON 只有两种容器

不管接口返回的数据有多复杂,拆到最后只有两种容器和六种值。对象(object)是一组「键值对」,用花括号 {} 包起来;数组(array)是一串按顺序排列的值,用方括号 [] 包起来。值可以是字符串、数字、true/false、null,也可以再嵌套对象或数组——对象套数组、数组套对象,就这样组合出所有真实数据。

{
  "user": { "name": "Ada", "active": true },
  "roles": ["admin", "editor"],
  "lastLogin": null,
  "loginCount": 42
}

这个认知很实用:遇到看不懂的 JSON,不要从第一个字符往下读,先找最外层是 { 还是 [。是对象,就按字段理解;是数组,就按列表理解,再逐层往里拆。json.org 的语法图一共只有一页,原因正是如此:两种结构加上递归嵌套,表达能力就够用了。

二、对象的写法:四条硬规则

对象是新手出错最密集的地方,规则其实只有四条:

  1. 键必须是双引号字符串。{name: "Ada"}、{'name': 'Ada'} 都不合法,必须是 {"name": "Ada"}。JavaScript 对象字面量允许裸键和单引号,但 JSON 不允许——这是两者最常见的混淆点。
  2. 键值对之间用逗号分隔,最后一个后面不能有逗号。{"a": 1, "b": 2,} 会在右花括号处报 Unexpected token }。
  3. 键应当唯一。RFC 8259 用的是 SHOULD 而不是 MUST,重复键不报错,但取第一个还是最后一个由解析器决定,不同语言结果可能不同,不能依赖。
  4. 键的顺序没有语义。{"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。