CopyToAsync无法报告进度因其仅执行字节搬运且不暴露已复制量或总大小；需手动用ReadAsync+WriteAsync分块读写并配合IProgress更新UI。
为什么 CopyToAsync 不能直接报告进度
CopyToAsync 是 Stream 类提供的标准异步复制方法，但它只负责字节搬运，不暴露已复制字节数或总大小。你调用 sourceStream.CopyToAsync(destStream) 后，除非自己拆解读写循环，否则无法在中途获取进度。它适合“只管完成、不关心过程”的场景，但不符合“带进度”需求。
用 ReadAsync + WriteAsync 手动分块读写
核心思路是：自己控制缓冲区，每次读一块、写一块，并在每次写完后更新进度。关键点在于：
- 缓冲区大小建议设为
8192或65536（8KB–64KB），太小会增加调度开销，太大可能阻塞 UI 线程或占用过多内存 - 必须使用同一个
CancellationToken同时传给ReadAsync和WriteAsync，否则取消操作可能不响应 - 总大小需提前通过
FileInfo.Length获取，不能依赖流的Length（如NetworkStream不支持） - 记得在每次
WriteAsync后调用await destStream.FlushAsync()（尤其目标为文件时，.NET 6+ 的FileStream默认启用写缓存）
示例片段：
var buffer = new byte[8192];
long totalRead = 0;
long totalBytes = sourceFileInfo.Length;
<p>while (totalRead < totalBytes)
{
int read = await sourceStream.ReadAsync(buffer, cancellationToken);
if (read == 0) break;</p><pre class='brush:php;toolbar:false;'>await destStream.WriteAsync(buffer, 0, read, cancellationToken);
await destStream.FlushAsync(cancellationToken); // 确保写入磁盘
totalRead += read;
progress?.Report((double)totalRead / totalBytes);}
如何安全地在 UI 线程更新进度（WinForms / WPF）
直接在后台任务里调用 ProgressBar.Value 或 Label.Text 会抛出 InvalidOperationException：“线程间操作无效”。正确做法是：
- WinForms：用
IProgress<T>构造时传入new Progress<double>(v => progressBar1.Invoke(() => progressBar1.Value = (int)(v * 100))) - WPF：用
Dispatcher.Invoke或绑定到INotifyPropertyChanged属性（推荐后者，更松耦合） - 避免在
Report回调里做耗时操作（如格式化字符串、IO、复杂计算），否则拖慢复制本身
注意 FileStream 的创建方式和参数影响性能与取消行为
异步文件复制对 FileStream 的初始化很敏感：
- 源流必须用
FileAccess.Read+FileOptions.Asynchronous，否则ReadAsync可能退化为同步阻塞 - 目标流要用
FileAccess.Write+FileOptions.Asynchronous+useAsync: true（构造函数最后一个 bool 参数） - 不要用
File.Copy包裹成Task.Run—— 这只是伪异步，仍占线程池线程，且无法真正取消 - .NET 5+ 支持
FileStream的Cancelable模式，但需确保 OS 层支持（Windows 10 1809+、Linux 5.1+）；旧系统上取消可能延迟到下一次 IO 完成
容易被忽略的是：如果目标路径所在磁盘空间不足，异常通常在 WriteAsync 阶段才抛出，而不是开头——所以进度接近 100% 时突然失败，得做好 IOException 的捕获和清理（比如删掉部分写入的目标文件）。
