Flutter中从Firebase Firestore仅获取name字段的方法及示例

Firestore支持字段投影（Field Projection），可以指定只返回需要的字段，既能减少数据传输量，也能避免获取敏感字段（比如你的password）。以下是不同开发平台的实现示例：

Web端（JavaScript） #

// 初始化Firestore实例（假设已完成Firebase配置）
import { getFirestore, collection, query, select, getDocs } from "firebase/firestore";
const db = getFirestore();

// 创建查询，仅指定获取name字段
const q = query(collection(db, "userdetails"), select("name"));

// 执行查询并处理结果
const querySnapshot = await getDocs(q);
querySnapshot.forEach((doc) => {
  // doc.data() 只会包含name字段
  console.log(`${doc.id}: ${doc.data().name}`);
});

Android端（Kotlin） #

// 初始化Firestore实例
val db = FirebaseFirestore.getInstance()

// 创建查询，仅获取name字段
db.collection("userdetails")
    .select("name")
    .get()
    .addOnSuccessListener { querySnapshot ->
        for (document in querySnapshot) {
            // document.data 仅包含name字段
            val userName = document.getString("name")
            Log.d("Firestore", "${document.id}: $userName")
        }
    }
    .addOnFailureListener { exception ->
        Log.w("Firestore", "获取数据失败", exception)
    }

iOS端（Swift） #

// 初始化Firestore实例
let db = Firestore.firestore()

// 创建查询，仅获取name字段
db.collection("userdetails")
    .getDocuments(source: .default, fieldMask: ["name"]) { querySnapshot, error in
        if let error = error {
            print("获取数据失败: \(error)")
            return
        }
        guard let documents = querySnapshot?.documents else {
            print("没有找到文档")
            return
        }
        for document in documents {
            // document.data() 仅包含name字段
            if let userName = document.data()["name"] as? String {
                print("\(document.documentID): \(userName)")
            }
        }
    }

注意点 #

• 字段投影只适用于顶层字段，嵌套字段需要用点语法（比如select("profile.name")，如果有嵌套结构的话）
• 即使指定了字段投影，文档的ID依然会被返回，可通过doc.id获取每个文档的唯一标识

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