使用IProgress<T>时任务先完成才通知进度的原因及修复方案

你遇到的这个“任务先完成才通知进度”的问题，核心原因是你用了Task.WaitAll()阻塞了UI线程！

这里得拆解下Progress<T>的工作逻辑：它在实例化时会自动捕获当前的同步上下文（对于UI程序来说，就是UI线程的SynchronizationContext）。当你调用Report()方法上报进度时，它会把进度更新的回调逻辑投递到这个同步上下文的消息队列里等待执行。但如果UI线程被Task.WaitAll()死死卡住，消息队列里的进度更新回调根本没机会被处理，只能等到所有任务跑完、WaitAll()释放UI线程后，这些回调才会被批量执行——这就导致你看到“任务先完成，进度才一下子跳出来”的现象。

把阻塞式的Task.WaitAll()换成异步非阻塞的await Task.WhenAll()，这样UI线程不会被卡死，能及时处理进度更新的回调。

错误代码示例（导致进度延迟） #

// 假设这是UI线程中的方法
private void StartTasks()
{
    var progress = new Progress<int>(UpdateProgressUI);
    var tasks = new List<Task>();

    for (int i = 0; i < 10; i++)
    {
        int taskIndex = i;
        tasks.Add(Task.Run(() =>
        {
            // 模拟工作单元
            for (int j = 0; j < 100; j++)
            {
                Thread.Sleep(10);
                progress.Report((taskIndex * 100) + j);
            }
        }));
    }

    // 这里直接阻塞了UI线程！
    Task.WaitAll(tasks.ToArray());
    MessageBox.Show("所有任务完成");
}

private void UpdateProgressUI(int progressValue)
{
    // 更新UI进度条或文本
    progressBar.Value = progressValue;
}

修复后的异步代码 #

// 改成async方法，返回Task
private async void StartTasks()
{
    var progress = new Progress<int>(UpdateProgressUI);
    var tasks = new List<Task>();

    for (int i = 0; i < 10; i++)
    {
        int taskIndex = i;
        tasks.Add(Task.Run(() =>
        {
            // 模拟工作单元
            for (int j = 0; j < 100; j++)
            {
                Thread.Sleep(10);
                progress.Report((taskIndex * 100) + j);
            }
        }));
    }

    // 用await异步等待，不会阻塞UI线程
    await Task.WhenAll(tasks.ToArray());
    MessageBox.Show("所有任务完成");
}

private void UpdateProgressUI(int progressValue)
{
    // 更新UI进度条或文本
    progressBar.Value = progressValue;
}

• 绝对不要在UI线程中调用任何阻塞式方法（比如Wait()、Result、WaitAll()），这不仅会导致进度更新异常，还会让整个程序失去响应。
• 如果你的工作单元本身是异步的（比如调用了返回Task的IO操作），那连Task.Run()都可以省略，直接await异步方法即可，进度报告逻辑保持不变。

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