如何从Cloud Firestore获取指定字段值或对象列表？

一、仅获取指定字段（如startTime） #

Firestore返回的doc.data()本质是Map<String, dynamic>，直接通过键名提取目标字段即可，不需要转JSON：

QuerySnapshot querySnapshot = await FirebaseFirestore.instance.collection("section").get();

// 仅提取单个字段（比如startTime）
final allStartTimes = querySnapshot.docs.map((doc) => doc.data()['startTime']).toList();

// 提取多个指定字段，返回精简后的Map列表
final filteredData = querySnapshot.docs.map((doc) {
  final data = doc.data() as Map<String, dynamic>;
  return {
    'startTime': data['startTime'],
    'date': data['date'] // 按需添加其他字段
  };
}).toList();

二、转为自定义对象列表（更优实践） #

这是类型安全、代码可读性更高的方案，先定义实体类：

class Section {
  final String startTime;
  final String stopTime;
  final String date;
  final int duration;
  final String weekday;

  Section({
    required this.startTime,
    required this.stopTime,
    required this.date,
    required this.duration,
    required this.weekday,
  });

  // 从Map转换为Section对象的工厂方法
  factory Section.fromMap(Map<String, dynamic> map) {
    // 可添加空值兜底，避免字段缺失导致崩溃
    return Section(
      startTime: map['startTime'] as String? ?? '',
      stopTime: map['stopTime'] as String? ?? '',
      date: map['date'] as String? ?? '',
      duration: map['duration'] as int? ?? 0,
      weekday: map['weekday'] as String? ?? '',
    );
  }
}

然后在获取数据时直接转成对象列表：

QuerySnapshot querySnapshot = await FirebaseFirestore.instance.collection("section").get();
final sectionList = querySnapshot.docs
    .map((doc) => Section.fromMap(doc.data() as Map<String, dynamic>))
    .toList();

之后就可以通过sectionList[0].startTime这种直观方式访问字段，完全规避键名拼写错误和类型混乱问题。

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