Flutter Firestore 如何获取数组下Map结构中的指定字段值

前置准备 #

首先确保你已在项目中引入cloud_firestore依赖，并完成Firebase初始化配置。

单文档指定字段获取 #

你可以通过DocumentSnapshot的get()方法直接读取指定字段，示例代码如下：

import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> fetchTargetField() async {
  // 替换为你实际的集合名称、文档ID
  final docRef = FirebaseFirestore.instance
      .collection('你的集合名')
      .doc('对应文档ID');
  
  final docSnapshot = await docRef.get();
  if (docSnapshot.exists) {
    // 替换为你红下划线标注的字段名，注意大小写完全匹配
    final targetValue = docSnapshot.get('你要获取的字段名');
    // 此处可直接使用拿到的targetValue
    print('字段值为: $targetValue');
  }
}

集合下全部文档的指定字段获取 #

如果需要批量获取集合下所有文档的对应字段，可参考如下代码：

Future<void> fetchAllTargetFields() async {
  final querySnapshot = await FirebaseFirestore.instance
      .collection('你的集合名')
      .get();
  
  for (var doc in querySnapshot.docs) {
    final targetValue = doc.get('你要获取的字段名');
    print('文档${doc.id}的目标字段值: $targetValue');
  }
}

常见注意事项 #

• 字段名需要和Firestore控制台中显示的名称完全一致，大小写敏感，拼写错误会导致取值失败
• 如果要获取嵌套Map内的字段，使用点分隔写法即可，例如要获取user字段下的age属性，写法为doc.get('user.age')
• 操作前确认Firebase安全规则开放了对应集合/文档的读权限，否则会抛出权限拒绝异常

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