Flutter：使用StreamBuilder实现目录列表遇异常问题求助

问题原因 #

• build方法中直接修改状态变量：Flutter的build()会被多次触发（初始渲染、父组件重建、依赖变更等都是正常场景），如果在build里执行_repositoriesList.add(...)这类操作，每次build都会重复添加数据，导致列表出现重复项。
• Stream事件重复发射：如果生成目录列表的Stream没有做去重处理，或者每次都返回包含相同项的结果，StreamBuilder会多次接收重复数据，进而触发重复构建逻辑。
• 路径与目录过滤逻辑错误：Dart中~不会自动解析为用户根目录，硬编码该路径会导致目录找不到；另外如果没有过滤出子目录（误将文件也纳入结果），也会不符合预期。

解决方法 #

1. 禁止在build方法中修改状态 #

build()仅用来描述UI结构，任何有副作用的操作（状态更新、文件IO、数据添加等）都要移到initState、Stream回调或其他生命周期方法中，避免重复执行。

2. 正确实现目录列表Stream #

让Stream直接返回去重后的子目录列表，确保每次发射的都是唯一数据：

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

class ArmiesPage extends StatefulWidget {
  @override
  _ArmiesPageState createState() => _ArmiesPageState();
}

class _ArmiesPageState extends State<ArmiesPage> {
  late Stream<List<String>> _repoStream;

  @override
  void initState() {
    super.initState();
    _repoStream = _getRepositoryDirectories();
  }

  Stream<List<String>> _getRepositoryDirectories() async* {
    // 正确解析用户根目录
    final homeDir = Platform.environment['HOME'];
    if (homeDir == null) {
      yield [];
      return;
    }
    final repoDir = Directory('$homeDir/Documents/army_maker/repositories');
    
    // 检查目录是否存在
    if (!await repoDir.exists()) {
      yield [];
      return;
    }

    // 获取直接子目录并提取名称
    final dirs = await repoDir.list(recursive: false)
        .where((entity) => entity is Directory)
        .map((dir) => dir.path.split(Platform.pathSeparator).last)
        .toList();
    
    // 去重，避免重复事件导致列表重复
    final uniqueDirs = dirs.toSet().toList();
    yield uniqueDirs;
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Repositories')),
      body: StreamBuilder<List<String>>(
        stream: _repoStream,
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          if (snapshot.hasError) {
            return Center(child: Text('加载失败: ${snapshot.error}'));
          }
          final repos = snapshot.data ?? [];
          return ListView.builder(
            itemCount: repos.length,
            itemBuilder: (context, index) {
              return ListTile(title: Text(repos[index]));
            },
          );
        },
      ),
    );
  }
}

3. 适配多平台的目录获取（可选） #

如果需要支持iOS/Android等多平台，推荐使用path_provider库获取标准文档目录，替代硬编码路径：

import 'package:path_provider/path_provider.dart';

// 在_getRepositoryDirectories中替换路径逻辑
final appDocDir = await getApplicationDocumentsDirectory();
final repoDir = Directory('${appDocDir.path}/army_maker/repositories');

4. 实时监听目录变化（可选） #

如果需要监听目录的新增/删除操作，建议使用成熟的第三方库（如watchdog），避免手动处理文件系统事件的重复和异常。

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