Cloud Firestore：如何用Map<String, dynamic>创建并更新嵌套数组

DevOps 小满

2026-8-2

在Cloud Firestore中用Map<String, dynamic>定义嵌套数组并完成增改操作

1. 定义嵌套数组的Map结构

根据需求，用Map<String, dynamic>可以这样定义包含嵌套数组的数据结构（示例可根据实际字段调整）：

Map<String, dynamic> nestedArrayData = {
  "parentArray": [
    {
      "itemTitle": "分组1",
      "subItems": ["子项A", "子项B", "子项C"]
    },
    {
      "itemTitle": "分组2",
      "subItems": ["子项X", "子项Y"]
    }
  ]
};

2. 创建文档并写入嵌套数组

通过set方法将定义好的Map写入Firestore文档：

import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> createDocumentWithNestedArray() async {
  await FirebaseFirestore.instance
      .collection('target_collection') // 替换为你的集合名
      .doc('target_doc_id') // 替换为你的文档ID
      .set(nestedArrayData);
}

3. 更新嵌套数组数据

方式一：覆盖整个嵌套数组字段

直接通过update方法替换整个嵌套数组：

Future<void> updateWholeNestedArray() async {
  await FirebaseFirestore.instance
      .collection('target_collection')
      .doc('target_doc_id')
      .update({
    "parentArray": [
      {
        "itemTitle": "更新后的分组1",
        "subItems": ["更新子项A", "更新子项B"]
      }
    ]
  });
}

方式二：往嵌套子数组中添加元素

使用Firestore的FieldValue.arrayUnion方法，在不覆盖原有数据的前提下添加新元素（自动去重）：

Future<void> addItemToChildArray() async {
  await FirebaseFirestore.instance
      .collection('target_collection')
      .doc('target_doc_id')
      .update({
    // 通过索引定位到目标子数组，parentArray.0表示第一个分组
    "parentArray.0.subItems": FieldValue.arrayUnion(["新增子项D"])
  });
}