如何用Flutter从Firebase集合中仅显示文档名称（无需关联字段）

你完全可以直接获取文档的唯一名称（也就是Firebase Firestore里的文档ID），不需要读取文档内的任何字段，具体实现如下：

核心逻辑 #

查询courses集合时，每个返回的DocumentSnapshot对象自带id属性，这个属性就是文档的唯一名称/ID，无需读取文档的字段内容，和你说的“显示文件夹内所有文件名”逻辑完全一致。

代码示例 #

1. 依赖配置 #

确保pubspec.yaml中已添加Firebase相关依赖：

dependencies:
  flutter:
    sdk: flutter
  cloud_firestore: ^4.15.0 # 请使用最新版本
  firebase_core: ^2.24.0 # 请使用最新版本

2. 获取并展示文档名称 #

以下是一个简单的组件示例，直接获取并展示courses集合下所有文档的名称：

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

class CourseDocumentNames extends StatefulWidget {
  const CourseDocumentNames({super.key});

  @override
  State<CourseDocumentNames> createState() => _CourseDocumentNamesState();
}

class _CourseDocumentNamesState extends State<CourseDocumentNames> {
  final FirebaseFirestore _firestore = FirebaseFirestore.instance;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('课程文档名称')),
      body: StreamBuilder<QuerySnapshot>(
        // 监听courses集合变化，无需指定要获取的字段
        stream: _firestore.collection('courses').snapshots(),
        builder: (context, snapshot) {
          if (snapshot.hasError) {
            return const Center(child: Text('加载出错'));
          }

          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }

          // 从每个DocumentSnapshot中提取id（文档名称）
          final documentNames = snapshot.data!.docs.map((doc) => doc.id).toList();

          return ListView.builder(
            itemCount: documentNames.length,
            itemBuilder: (context, index) {
              return ListTile(
                title: Text(documentNames[index]),
              );
            },
          );
        },
      ),
    );
  }
}

关键说明 #

• 使用collection('courses').snapshots()监听集合时，返回的QuerySnapshot仅包含文档的元数据（包括文档ID），默认不会读取文档内的字段内容（除非主动调用doc.data()）。
• doc.id就是你需要的文档唯一名称，完全不需要依赖文档内的自定义字段。

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