JSON 数组

AI老李

于 2025-07-29 10:59:53 发布

阅读量990

点赞数 27

CC 4.0 BY-SA版权

分类专栏： json 前端文章标签： json

本文链接：https://blog.csdn.net/likuoelie/article/details/149742009

前端同时被 2 个专栏收录

90 篇文章

订阅专栏

json

8 篇文章

订阅专栏

JSON 数组中文讲解

JSON（JavaScript Object Notation）数组是 JSON 数据结构的另一个核心组成部分，用于表示有序的值列表。以下是对 JSON 数组的详细讲解，涵盖定义、语法、特点、操作方法以及在 Node.js 和 MongoDB 中的应用，全部用中文说明，力求简洁清晰。

1. 什么是 JSON 数组？

定义：JSON 数组是一组有序的值集合，用方括号 [] 包裹，值之间用逗号 , 分隔。值可以是 JSON 支持的任意数据类型（字符串、数字、布尔值、null、对象、数组）。
用途：JSON 数组用于表示列表、集合或序列数据，广泛应用于 Web API、MongoDB 文档、配置文件等场景。

示例：

[
  "苹果",
  42,
  true,
  null,
  {"name": "张三"},
  [1, 2, 3]
]

2. JSON 数组语法规则

JSON 数组的语法简单且严格，需遵守以下规则：

结构：
- 用方括号 [] 包裹。
- 包含零个或多个值，值之间用逗号 , 分隔。
- 最后一个值后不能加逗号。
值类型：
- 可以是以下类型：
  - 字符串（"hello"）
  - 数字（42、3.14）
  - 布尔值（true、false）
  - 空值（null）
  - 对象（{"key": "value"}）
  - 数组（嵌套数组，如 [1, 2]）
- 示例：
```
[
  "字符串",
  123,
  false,
  null,
  {"city": "北京"},
  [4, 5, 6]
]
```
分隔符：
- 值之间用逗号 , 分隔。
- 空数组表示为 []。
空白字符：
- 支持空格、换行、制表符，仅影响格式化，不影响数据。
不支持的特性：
- 不支持注释。
- 不支持函数、日期对象、undefined 等 JavaScript 特有类型。

错误示例：

["苹果", "香蕉",]  // 错误：最后一个元素后多余逗号
["item": "value"]   // 错误：数组不能包含键值对

3. JSON 数组的特点

有序：数组中的值按顺序排列，解析后保持原始顺序（与 JSON 对象的无序性不同）。
嵌套支持：数组可以包含其他数组或对象，支持复杂数据结构。
轻量：语法简洁，数据体积小，适合网络传输。
跨语言：JSON 数组是语言无关的格式，几乎所有编程语言都支持解析。

4. 在 Node.js 中操作 JSON 数组

Node.js 提供内置的 JSON 对象，用于解析和生成 JSON 数组。

4.1 解析 JSON 数组

将 JSON 数组字符串转换为 JavaScript 数组：

const jsonString = '["苹果", "香蕉", 42, {"name": "李四"}]';
try {
  const arr = JSON.parse(jsonString);
  console.log(arr[0]); // 输出：苹果
  console.log(arr[3].name); // 输出：李四
} catch (error) {
  console.error('解析错误：', error.message);
}

注意：如果 JSON 字符串语法错误（如多余逗号），JSON.parse 会抛出 SyntaxError。

4.2 生成 JSON 数组

将 JavaScript 数组转换为 JSON 字符串：

const arr = ["读书", "旅行", { score: 95 }, [1, 2, 3]];
const jsonString = JSON.stringify(arr, null, 2); // 格式化输出，2表示缩进空格数
console.log(jsonString);
/* 输出：
[
  "读书",
  "旅行",
  {
    "score": 95
  },
  [
    1,
    2,
    3
  ]
]
*/

参数说明：
- JSON.stringify(value, replacer, space)：
  - value：要转换的数组。
  - replacer：可选函数，用于过滤或转换值。
  - space：可选，控制缩进（如 2 表示 2 个空格）。

4.3 访问 JSON 数组

解析后的 JSON 数组是普通的 JavaScript 数组，可以通过索引访问：

const arr = JSON.parse('["苹果", {"name": "王五"}, [10, 20]]');
console.log(arr[0]); // 输出：苹果
console.log(arr[1].name); // 输出：王五
console.log(arr[2][1]); // 输出：20

5. JSON 数组与 MongoDB

JSON 数组在 MongoDB 中常用于存储列表数据，如用户的兴趣列表、订单项等。Node.js 的 MongoDB 驱动可以直接操作 JSON 数组。

示例：插入和查询 JSON 数组

const { MongoClient } = require('mongodb');
const uri = 'mongodb://localhost:27017/myDatabase';
const client = new MongoClient(uri);

async function run() {
  try {
    await client.connect();
    const db = client.db('myDatabase');
    const collection = db.collection('users');

    // 插入包含数组的 JSON 对象
    const user = {
      name: "张三",
      hobbies: ["读书", "旅行", "编程"],
      scores: [95, 88, 92]
    };
    await collection.insertOne(user);
    console.log('插入成功');

    // 查询包含特定数组元素的文档
    const result = await collection.findOne({ hobbies: "读书" });
    console.log('查询结果：', result);
  } catch (error) {
    console.error('操作失败：', error);
  } finally {
    await client.close();
  }
}
run();

说明：
- MongoDB 文档中的 hobbies 和 scores 字段是 JSON 数组。
- 查询支持数组操作，如查找包含特定元素的文档（$in、$all 等）。

高级查询示例：

// 查询 hobbies 包含 "读书" 和 "旅行" 的文档
const result = await collection.find({ hobbies: { $all: ["读书", "旅行"] } }).toArray();
console.log(result);

6. JSON 数组与 XML 的对比

特性	JSON 数组	XML 等效结构
语法	方括号 `[]`，逗号分隔值	重复标签（如 `<item>`）
有序性	有序，保持元素顺序	通常有序，但依赖解析器
体积	紧凑，数据量小	冗长，因标签重复
解析	Node.js 内置支持（`JSON.parse`）	需要额外库（如 `xml2js`）
注释	不支持	支持（`<!-- 注释 -->`）

JSON 数组示例：

["苹果", "香蕉", {"name": "李四"}]

XML 等效示例：

<items>
  <item>苹果</item>
  <item>香蕉</item>
  <item>
    <name>李四</name>
  </item>
</items>

优势：JSON 数组更简洁，解析更快，适合 Node.js 和 MongoDB。
劣势：JSON 不支持注释，XML 更适合复杂元数据描述。

7. 常见问题与注意事项

语法错误：
- 最后一个元素后多余逗号会导致解析失败。
- 示例：
```
["苹果", "香蕉",]  // 错误：多余逗号
```
嵌套限制：
- JSON 数组支持多层嵌套，但过深可能影响可读性和性能。
- 建议嵌套层数控制在 3-5 层。
数据类型限制：
- 不支持 JavaScript 的 undefined、函数、Date 等类型。
- 解决方法：将特殊类型转换为字符串或数字（如 Date 转为 ISO 字符串）。
调试技巧：
- 使用 JSON.stringify(arr, null, 2) 格式化输出，便于检查复杂数组。
- 在线工具（如 JSONLint）可验证 JSON 数组语法。