必须用HttpClient+Stream手动搬运实现限速：调用GetAsync(...ResponseHeadersRead)获取响应流，分块读取、动态计算Sleep时间，全程传入CancellationToken，用Stopwatch精准计时，并根据磁盘和网络实际能力动态调整目标速率。
DownloadDataAsync 无法限速，得换 DownloadFileAsync 或手动流控制
直接用 WebClient.DownloadDataAsync 或 HttpClient.GetAsync 拿到整个 byte[] 再写入磁盘，中间没机会插手流速。真要控速，必须自己读取响应流、按节奏写入文件，并在每次写入后主动延时。
推荐走 HttpClient + Stream 手动搬运路线：它支持取消、进度回调，且能精确控制每批读取字节数和等待时间。
- 别用
WebClient.DownloadFileAsync—— 它不暴露底层流，没法插限速逻辑 -
HttpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead)是关键，避免提前缓冲整个响应体 - 用
response.Content.ReadAsStreamAsync()拿到原始响应流，后续完全可控
每读 chunk 就 Sleep，但 Sleep 时间得动态算
固定 Thread.Sleep(10) 看似简单，实际会严重偏离目标速率：网络抖动、磁盘 IO 延迟、GC 暂停都会让真实耗时浮动。正确做法是记录「本批次开始时间」，读完写完后计算已用时间，再补足到目标间隔。
比如目标 500 KB/s，每次读 8 KB，则理想间隔 = 8 * 1024 / (500 * 1024) ≈ 0.016 秒 → 16ms。但若本次操作实际花了 12ms，就只 Sleep 4ms；若花了 18ms，就跳过 Sleep。
- 用
Stopwatch而非DateTime.Now测时，精度更高 - 目标速率单位统一用
bytesPerSecond，避免 KB/MB 换算出错 - 单次读取大小建议设为 4–64 KB：
buffer.Length太小（如 1KB）会导致频繁 Sleep 调用，开销大；太大（如 1MB）则一次卡顿就拖垮整条节奏
取消令牌和异常处理不是可选项
限速逻辑里加了 await Task.Delay(...)，这就意味着方法变成异步可中断点。如果用户点了“暂停”或“取消”，不响应 CancellationToken 会导致界面卡死、资源泄漏。
同时，网络请求中途断开、磁盘满、权限不足这些异常，一旦发生在 Sleep 之后、下一次 ReadAsync 之前，就会丢失上下文——你得确保 finally 块里释放流、关闭文件句柄，且所有 await 都传入 token。
-
ReadAsync(buffer, cancellationToken)和WriteAsync(fileStream, buffer, cancellationToken)都必须传 token -
Task.Delay(ms, cancellationToken)同样要传，否则 Cancel 会被忽略 - 文件流务必用
using var fileStream = File.Create(...)，别靠 GC 回收 - 捕获
OperationCanceledException单独处理，别跟网络异常混在一起 throw
实际速率受磁盘和 TCP 接收窗口制约，别迷信理论值
即使代码逻辑完美，最终下载速度仍可能远低于设定值：如果目标磁盘是机械硬盘或 USB 2.0 设备，持续写入吞吐可能只有 20 MB/s；而 TCP 层的接收窗口大小、服务器端发送节奏、中间代理缓冲等，都会让可用带宽波动。
更现实的做法是：启动时用短时采样（比如前 2 秒）估算当前管道能力，再把目标速率设为估算值的 70%～90%，后续还可根据实时误差微调 Sleep 时间。
- 别在日志里硬打 “限速已生效”，改打 “目标 500 KB/s，实测 412 KB/s（±12%）”
- 如果连续 5 秒实测速率低于目标 50%，考虑自动降速并告警，而不是强行拉满 CPU 等 Sleep
- 同一台机器多个下载任务共用一个限速控制器时，注意共享的
Stopwatch实例或计时器竞争问题
真正难的不是算 Sleep 时间，而是让限速行为对上层业务透明、不破坏取消语义、且在磁盘慢于网络时依然稳定。这些细节堆起来，才决定它到底能不能进生产环境。
