Flutter(Dart)中向嵌套Map列表的任务添加活动及Firestore嵌套数据存储问题

一、向指定任务添加活动 #

你已经用List<Map<String, dynamic>>搭建好了任务+活动的结构，给指定任务加活动其实很直接，核心是正确获取任务里的activity列表并完成添加操作。

示例1：给最后一个任务添加活动 #

先拿到最后一个任务，把它的activity字段明确转换成List类型（因为dynamic类型需要强转才能调用List的方法），再把新活动加进去：

// 定义要添加的新活动
final newActivity = {
  'activityType': 'XXX',
  'trainingActivityDetail': null,
  'wapolJobNumber': '000',
  'rapNumber': '999',
  'activityStart': '19:00',
  'activityFinish': '20:00',
  'startFuel': 1000,
  'endFuel': 3000,
  'fuelUsed': 2000,
};

// 获取最后一个任务
final lastDuty = duties.last;
// 取出activity列表并强转类型
final activities = lastDuty['activity'] as List<Map<String, dynamic>>;
// 加入新活动
activities.add(newActivity);

执行完这段代码，最后一个任务的activity数组就会新增一项，变成2个活动。

示例2：给指定索引的任务添加活动 #

如果要给特定位置的任务（比如第2个任务，索引为1）加活动，逻辑完全一致：

// 目标任务索引，这里选第2个任务（索引从0开始）
final targetIndex = 1;
final targetDuty = duties[targetIndex];
final activities = targetDuty['activity'] as List<Map<String, dynamic>>;
activities.add(newActivity);

二、Firestore存储嵌套的活动列表 #

Firestore天生支持嵌套的数组和Map结构，所以存储带活动列表的任务不需要额外做特殊处理，直接把整个任务Map传给Firestore即可。

存储单个任务（包含活动列表） #

比如把你刚添加完活动的任务存到Firestore的duties集合里：

import 'package:cloud_firestore/cloud_firestore.dart';

// 假设这是你要存储的完整任务（包含2个活动）
final dutyToSave = duties.last;

// 上传到Firestore
FirebaseFirestore.instance.collection('duties').add(dutyToSave)
  .then((docRef) => print('任务已存储，文档ID: ${docRef.id}'))
  .catchError((error) => print('存储失败: $error'));

Firestore会自动把activity数组作为嵌套结构存在文档中，你在Firebase控制台里能看到这个字段，里面清晰展示每个活动的键值对。

从Firestore读取嵌套的活动列表 #

读取时只需要把文档数据里的activity字段转回List<Map<String, dynamic>>就行：

// 读取指定文档
FirebaseFirestore.instance.collection('duties').doc('你的文档ID').get()
  .then((docSnapshot) {
    if (docSnapshot.exists) {
      final dutyData = docSnapshot.data() as Map<String, dynamic>;
      // 解析活动列表
      final activities = dutyData['activity'] as List<Map<String, dynamic>>;
      // 后续可以把activities传给ListView Builder展示
      print('该任务共有${activities.length}项活动');
    }
  });

进阶小建议 #

如果后续你的业务逻辑变复杂，建议用Dart实体类来封装任务和活动，代替直接用Map。比如创建Duty和Activity类，写toJson()和fromJson()方法来和Firestore做数据转换，这样类型更安全，代码可读性也更高，能避免很多类型转换的坑。

内容的提问来源于stack exchange，提问作者Mark