如何获取目录遍历进度？需展示当前搜索的目录

问题根源 #

你当前使用的dir.GetDirectories("*", SearchOption.AllDirectories)是同步阻塞式的递归搜索，会一次性遍历所有层级的目录，导致UI线程被长时间占用，出现假死状态。要解决这个问题，需要改成分步递归+异步执行的方式，同时实时上报当前搜索的目录路径。

实现方案 #

1. 异步递归遍历方法（核心逻辑）

自己实现广度优先遍历，每处理一个目录就触发进度回调，同时用异步操作避免UI阻塞：

// 定义进度回调委托，用于传递当前搜索的目录
public delegate void SearchProgressHandler(string currentDirectory);

public async Task<List<DirectoryInfo>> SearchOldDirectoriesAsync(string rootPath, DateTime cutoffDate, SearchProgressHandler progressCallback)
{
    var matchedDirs = new List<DirectoryInfo>();
    var dirQueue = new Queue<string>();
    dirQueue.Enqueue(rootPath);

    while (dirQueue.Count > 0)
    {
        var currentDirPath = dirQueue.Dequeue();
        // 触发进度更新
        progressCallback?.Invoke(currentDirPath);

        DirectoryInfo currentDir;
        DirectoryInfo[] subDirs;
        try
        {
            currentDir = new DirectoryInfo(currentDirPath);
            // 异步获取子目录，避免IO阻塞UI线程
            subDirs = await Task.Run(() => currentDir.GetDirectories());
        }
        catch (UnauthorizedAccessException)
        {
            // 跳过无权限访问的目录
            continue;
        }

        // 检查当前目录是否符合条件
        if (currentDir.CreationTime < cutoffDate)
        {
            matchedDirs.Add(currentDir);
        }

        // 将子目录加入队列，继续遍历
        foreach (var subDir in subDirs)
        {
            dirQueue.Enqueue(subDir.FullName);
        }

        // 可选：给UI留更新时间，避免进度刷新过快
        await Task.Delay(10);
    }

    return matchedDirs;
}

2. UI层绑定进度反馈（以WinForms为例）

调用异步方法时，将进度更新绑定到UI控件，同时注意切换回UI线程：

private async void btnStartSearch_Click(object sender, EventArgs e)
{
    DateTime lastMonth = DateTime.Now.AddMonths(-1);
    string backupRoot = @"\\your-server\backup-folder";

    // 禁用按钮防止重复触发
    btnStartSearch.Enabled = false;
    lblProgress.Text = "开始搜索...";

    try
    {
        var result = await SearchOldDirectoriesAsync(
            backupRoot,
            lastMonth,
            currentDir =>
            {
                // WinForms中必须通过Invoke切换回UI线程更新控件
                if (lblProgress.InvokeRequired)
                {
                    lblProgress.Invoke(new Action(() => lblProgress.Text = $"正在搜索：{currentDir}"));
                }
                else
                {
                    lblProgress.Text = $"正在搜索：{currentDir}";
                }
            });

        MessageBox.Show($"搜索完成，共找到{result.Count}个符合条件的备份目录");
    }
    catch (Exception ex)
    {
        MessageBox.Show($"搜索出错：{ex.Message}");
    }
    finally
    {
        btnStartSearch.Enabled = true;
        lblProgress.Text = "搜索结束";
    }
}

3. 关键优化点

• 异步IO操作：用Task.Run包裹目录读取操作，避免UI线程被IO阻塞
• 分步遍历：通过队列实现广度优先搜索，每处理一个目录就更新进度
• 异常处理：跳过无权限访问的目录，防止搜索中断
• UI线程切换：WinForms/WPF中必须通过Invoke回到UI线程更新控件，避免跨线程操作错误

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