BackgroundWorker.CancelAsync() 仅设置取消标志，不终止 DoWork；必须在 DoWork 中主动检查 CancellationPending 并退出，否则 RunWorkerCompleted 不会触发。
BackgroundWorker.CancelAsync() 不会自动停止正在运行的 DoWork
很多人以为调用 CancelAsync() 就能立刻中断后台任务，其实它只是把 WorkerSupportsCancellation 设为 true 后，把 CancellationPending 设为 true —— 具体停不停，全靠你在 DoWork 里主动检查并退出。
常见错误现象：DoWork 里跑了一个长循环或阻塞 IO（比如 Thread.Sleep(5000) 或未设超时的 WebClient.DownloadString()），调用 CancelAsync() 后界面响应了，但线程还在后台跑，甚至可能引发重复取消、状态错乱。
- 必须在
DoWork的关键位置（尤其是循环开头、IO 调用前）手动检查e.Cancel = worker.CancellationPending - 如果用了阻塞式 IO，优先换成带取消支持的异步版本（如
HttpClient.GetAsync(..., cancellationToken)），BackgroundWorker本身不提供CancellationToken - 避免在
DoWork中直接调用worker.CancelAsync()—— 这是 UI 线程方法，跨线程调用会抛InvalidOperationException
RunWorkerCompleted 里怎么区分是完成、取消还是异常
RunWorkerCompleted 的 RunWorkerCompletedEventArgs 通过三个布尔属性告诉你发生了什么：e.Error、e.Cancelled、e.Result。它们不是互斥开关，而是组合判断依据。
使用场景：你想在任务结束后更新 UI，但得知道该显示“成功”、“已取消”还是“出错了”。直接看 e.Cancelled 是最可靠的取消标识；e.Error != null 才代表异常；e.Result 只有没取消也没异常时才安全访问。
- 先检查
e.Cancelled：为true就说明用户点了取消，忽略e.Error和e.Result - 再检查
e.Error != null：此时一定不是取消，而是DoWork抛了未捕获异常 -
e.Result只在!e.Cancelled && e.Error == null时有效，否则访问会触发NullReferenceException或掩盖真实问题
BackgroundWorker 在 .NET Core / .NET 5+ 里还能用吗
能用，但微软明确标记为“遗留组件”，BackgroundWorker 类型仍存在于 System.ComponentModel 命名空间中，所有现代 .NET 版本都保留兼容性。
不过它的设计模型（基于事件 + 手动取消检查）和当前主流异步模式（async/await + CancellationToken）存在根本冲突。比如你无法在 DoWork 里写 await，强行用 Task.Run(() => { ... }).Wait() 会阻塞后台线程，失去意义。
- 新项目别再选
BackgroundWorker，改用Task.Run+CancellationTokenSource组合更简洁可控 - 老 WinForms 项目维护时，如果已有大量
BackgroundWorker逻辑，不必强行重写，但新增功能建议统一用IHostedService（服务场景）或Task+Progress<T>（UI 场景） - 注意：WinUI / MAUI / Blazor 中没有
BackgroundWorker，也无需它 —— 它本质是 WinForms/WPF 时代对 STA 线程模型的妥协产物
为什么调用 CancelAsync() 后 RunWorkerCompleted 没触发
最常见原因是：你在 DoWork 里没及时响应取消请求，或者压根没检查 CancellationPending，导致后台线程一直卡在某个地方，RunWorkerCompleted 就永远等不到执行机会。
另一个隐蔽坑是：在 DoWork 中调用了 UI 控件属性（比如 label.Text = "xxx"），而没走 Invoke 或 BeginInvoke，这会导致死锁或静默失败（尤其在某些 .NET 版本下不抛异常，只是卡住）。
- 确保
DoWork函数体结尾有明确 return，且所有分支（包括异常 catch 块）都设置了e.Cancel或e.Result - 不要在
DoWork中访问任何 UI 控件 —— 需要反馈进度就用ReportProgress，需要最终结果就在RunWorkerCompleted里更新 UI - 调试时加日志：在
DoWork开头、循环内、退出前都打一行Debug.WriteLine($"CancellationPending: {worker.CancellationPending}")，确认取消信号是否被看到
