backgroundworker 在 winforms 中需严格遵循线程安全规则：dowork 不能操作 ui 控件，须用 progresschanged 或 runworkercompleted 更新；传参通过 runworkerasync() 和 e.argument，返回值赋给 e.result；取消需手动检查 cancellationpending；三事件必须全部绑定，缺一不可。
BackgroundWorker 在 WinForms 中能跑通，但不是“写完就能用”的组件——漏掉任一事件绑定、在错误线程访问控件、忽略取消检查，都会直接崩溃或逻辑错乱。
DoWork 里为什么不能写 label1.Text = "xxx"？
因为 DoWork 在后台线程执行，而 WinForms 控件只能由创建它的 UI 线程访问。强行操作会立刻抛出 InvalidOperationException，提示“跨线程操作无效”。
- 所有 UI 更新必须挪到
ProgressChanged或RunWorkerCompleted中 -
DoWork内只放纯计算、文件读写、网络请求等不涉及控件的逻辑 - 如果真要传状态给 UI，用
worker.ReportProgress(50, "正在处理 config.json")，再在ProgressChanged里取e.UserState
怎么安全传参和拿返回值？
RunWorkerAsync() 支持传一个 object 参数，对应 DoWorkEventArgs.Argument；返回值必须赋给 e.Result，否则 RunWorkerCompleted 拿不到。
- 传参：调用
worker.RunWorkerAsync("data.csv")→ 在DoWork中用(string)e.Argument取出 - 返回：在
DoWork结尾写e.Result = new { Count = 127, DurationMs = 420 }; - 取结果：在
RunWorkerCompleted中用var result = e.Result as dynamic;或强转为具体类型 - 别传大对象（如
DataTable、未序列化的自定义类），避免 GC 压力和引用泄漏
CancelAsync 为啥点了没反应？
CancelAsync() 只是设标记，DoWork 必须主动检查并退出，否则任务照常跑完，e.Cancelled 也永远是 false。
- 每次循环开头加
if (worker.CancellationPending) { e.Cancel = true; return; } - 遇到阻塞调用（如
Thread.Sleep(1000)）时，换成可取消版本：await Task.Delay(1000, token)（需改用Task方案）或手动轮询 -
RunWorkerCompleted中必须同时判断e.Cancelled和e.Error == null，否则用户点了取消却弹出“成功”对话框
ProgressChanged 怎么传进度以外的信息？
ReportProgress 不只传数字，重载版 ReportProgress(int, object) 可带任意状态，比如当前文件名、已处理条数、中间结果。
- 在
DoWork中：worker.ReportProgress(65, new { File = "log_20260507.txt", Processed = 892 }) - 在
ProgressChanged中：var state = e.UserState as dynamic; progressBar1.Value = e.ProgressPercentage; label1.Text = $"处理中：{state.File}（{state.Processed} 条）"; - 注意
userState是原样透传，不跨线程拷贝，别传未同步的对象（如List<t></t>正在被其他线程修改）
最易被忽略的是：三个事件（DoWork、ProgressChanged、RunWorkerCompleted）必须全部绑定，缺一个就导致进度不更新、结果拿不到、异常被吞掉——这不是可选配置，是运行前提。
