BackgroundWorker 是 WinForms 中用于后台执行耗时操作的组件，通过 DoWork、ProgressChanged 和 RunWorkerCompleted 三个事件协同工作，支持进度报告与取消机制，但已标记为遗留技术，新项目推荐使用 Task.Run + async/await。
BackgroundWorker 已过时，但仍在 WinForms 项目中广泛使用；它能跑通，但不推荐新项目采用。 它的替代方案是 Task.Run + async/await，更轻量、更可控、更符合现代 C# 实践。不过如果你维护旧代码、或团队强制要求用 BackgroundWorker，那得清楚它怎么写才不出错、不卡死、不漏取消。
BackgroundWorker 的三个核心事件必须配对使用
它不是“启动就完事”的组件，DoWork、ProgressChanged、RunWorkerCompleted 这三个事件缺一不可，否则进度无法刷新、结果拿不到、异常被吞掉。
-
DoWork：只允许放纯计算逻辑，**绝对不能访问 UI 控件**（比如label1.Text = "xxx"），否则抛InvalidOperationException -
ProgressChanged：唯一安全更新 UI 的地方，前提是调用ReportProgress且WorkerReportsProgress = true -
RunWorkerCompleted：处理最终结果或异常，e.Error判断是否出错，e.Cancelled判断是否被取消，e.Result拿返回值——这些都发生在 UI 线程，可直接操作控件
ReportProgress 不只是传数字，还能带自定义状态
ReportProgress(int percent) 看似只能传进度百分比，其实支持重载 ReportProgress(int percent, object userState)，userState 可以是任意对象，比如当前处理的文件名、已处理条数、中间计算结果。
- 在
DoWork里：worker.ReportProgress(30, new { FileName = "data.csv", Count = 127 }) - 在
ProgressChanged里：var state = e.UserState as dynamic; label1.Text = $"处理中：{state.FileName} ({state.Count})" - 注意：不要传大对象或未序列化类型（如
DataTable），避免 GC 压力和跨线程引用问题
CancelAsync 不等于立刻停止，你得手动检查CancellationPending
CancelAsync() 只是设个标记，DoWork 方法内部必须定期轮询 e.Cancel 属性，否则点击“取消”按钮后任务照常跑完。
- 循环中每轮都要加：
if (e.Cancel) return;或throw new OperationCanceledException(); - 遇到阻塞调用（如
Thread.Sleep、Socket.Receive）时，需改用可取消版本（Task.Delay(..., token)、socket.ReceiveAsync(..., token)） -
RunWorkerCompleted中必须检查e.Cancelled，而不是只看e.Error == null，否则用户点了取消却显示“成功”
BackgroundWorker 和 Task.Run 的关键差异点
很多人混用两者，结果出现重复调度、上下文丢失、异常静默等问题。最常踩的坑是：在 DoWork 里又开了 Task.Run，导致两层后台线程嵌套。
-
BackgroundWorker：基于SynchronizationContext自动捕获 UI 上下文，ProgressChanged和RunWorkerCompleted天然在 UI 线程执行 -
Task.Run：默认在 ThreadPool 线程执行，await后是否回到 UI 线程，取决于是否捕获了上下文（WinForms 默认会，但若提前调用ConfigureAwait(false)就不会） - 性能上：
BackgroundWorker有额外事件分发开销；Task.Run更直接，也更容易链式组合（.ContinueWith、.WhenAll） - 兼容性上：
BackgroundWorker在 .NET Core/.NET 5+ WinForms 中仍可用，但微软文档已标注为“legacy”
真正麻烦的不是写法，而是取消逻辑和异常传播的边界——BackgroundWorker 把异常吞进 e.Error，而 Task 默认抛到调用栈；一个写错位置的 ReportProgress 调用，可能让界面卡在 99% 不动；这些细节不盯住，调试时根本看不出哪断了。
