WPF中使用BackgroundWorker结合ProgressBar的异步更新问题

问题分析 #

你的代码出现UI冻结、Label仅显示最后一个文件名的原因主要有三点：

1. GetFiles是延迟加载的枚举，无法提前获取总文件数，导致无法计算进度百分比；同时枚举过程中后台线程持续运行，UI线程可能因消息堆积无法及时更新。
2. 无差别吞掉所有异常，可能隐藏目录访问权限、目录不存在等问题，导致后台线程卡顿。
3. ReportProgress调用过于频繁时，UI线程来不及处理所有更新请求，最终只显示最后一次结果。

解决方案 #

以下是修改后的完整代码，解决UI冻结并实现实时进度更新：

1. 修改DoWork事件逻辑（预加载文件列表+计算进度）

private void Bgw_DoWork(object sender, DoWorkEventArgs e)
{
    // 预加载所有文件到列表，获取总数量用于计算进度百分比
    var filesList = GetFiles(@"D:\", "*.*").ToList();
    int totalFiles = filesList.Count;
    int currentCount = 0;

    foreach (var item in filesList)
    {
        currentCount++;
        // 计算当前进度百分比
        int progress = (int)((currentCount / (double)totalFiles) * 100);
        // 传递进度值和当前文件名到UI线程
        bgw.ReportProgress(progress, item);

        FileInfo info = new FileInfo(item);
        // GetFiles返回的文件必然存在，无需重复判断File.Exists
        dic.Add(item, info.Length);

        // 给UI线程预留极短处理时间，避免消息堆积导致UI冻结
        System.Threading.Thread.Sleep(10);
    }
}

2. 更新ProgressChanged事件（同步进度条与Label）

private void Bgw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    progressBar1.Value = e.ProgressPercentage;
    label1.Content = e.UserState as string;
}

3. 优化GetFiles方法（精准捕获异常，避免隐藏问题）

public static IEnumerable<string> GetFiles(string root, string searchPattern)
{
    Stack<string> pending = new Stack<string>();
    pending.Push(root);
    while (pending.Count != 0)
    {
        var path = pending.Pop();
        string[] next = null;

        // 仅捕获目录访问相关的常见异常，其他异常抛出便于调试
        try
        {
            next = Directory.GetFiles(path, searchPattern);
        }
        catch (UnauthorizedAccessException)
        {
            continue;
        }
        catch (DirectoryNotFoundException)
        {
            continue;
        }

        if (next != null && next.Length != 0)
            foreach (var file in next) yield return file;

        try
        {
            next = Directory.GetDirectories(path);
            foreach (var subdir in next) pending.Push(subdir);
        }
        catch (UnauthorizedAccessException)
        {
            continue;
        }
        catch (DirectoryNotFoundException)
        {
            continue;
        }
    }
}

关键说明 #

• 预加载文件列表：提前获取总文件数，才能计算准确的进度百分比；同时避免延迟枚举过程中可能的线程阻塞。
• 精准捕获异常：不再吞掉所有异常，只跳过无权限或不存在的目录，避免因隐藏问题导致后台线程卡顿。
• Thread.Sleep(10)：让后台线程暂停极短时间，给UI线程处理消息的机会，避免因ReportProgress调用过于频繁导致UI冻结。
• 线程安全：dic仅在后台线程操作，无需额外同步；如果后续需要在UI线程访问dic，建议在RunWorkerCompleted事件中处理。

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