限速下载的核心是用rate.limiter包装io.reader实现字节级精确限速，通过reserven+delay控制read节奏，每个goroutine需独占limiter，避免共享导致速率不均。
限速下载的核心是控制 io.Copy 的写入节奏
Go 标准库没有内置限速的 io.Reader 或 io.Writer，但可以通过包装底层 io.Reader 实现带宽限制。关键不是改 http.Get，而是让下载数据流经过一个“节流器”——即在 io.Copy 读取响应体时，用限速的 io.Reader 接收原始数据。
常见错误是试图对 http.Client.Timeout 或 context.WithTimeout 做限速，它们只控制连接/请求超时，和吞吐率无关；也有人误用 time.Sleep 在循环里读 chunk，这既不精确又容易破坏 TCP 流控。
- 推荐方式：用
golang.org/x/time/rate构建rate.Limiter，再封装成io.Reader，每次Read前按字节数申请令牌 - 不要直接在
http.Response.Body上做 sleep，会阻塞整个连接，影响复用 - 限速单位建议用
bytes/sec，而非KB/s或MB/s，避免整数除法丢失精度
用 rate.Limiter 包装 io.Reader 实现精确字节级限速
标准 rate.Limiter 默认按事件（如每秒 N 次）限流，但文件下载需按字节限速。得用 rate.Every 转换为“每秒 N 字节”，再配合 Limit.ReserveN 控制每次读取前的等待。
注意：不能用 Limiter.AllowN，它不阻塞；必须用 ReserveN + Delay 主动休眠，否则速率会超额。
// 创建每秒 512KB 的限速器
limiter := rate.NewLimiter(rate.Every(time.Second/512000), 512000)
// 包装 reader 的 Read 方法
type limitedReader struct {
r io.Reader
limiter *rate.Limiter
}
func (lr *limitedReader) Read(p []byte) (n int, err error) {
n, err = lr.r.Read(p)
if n > 0 {
// 按实际读到的字节数申请令牌
res := lr.limiter.ReserveN(time.Now(), n)
if !res.OK() {
return n, res.Err()
}
time.Sleep(res.Delay())
}
return n, err
}
- 每次
Read返回字节数后才申请对应令牌，避免预估不准导致突发流量 -
ReserveN可能返回!OK()（如上下文取消），需透传错误 - 如果下游
Write很慢（如写到机械硬盘），限速器仍会按读取节奏放行，实际速率由瓶颈环节决定
io.Copy 配合限速 Reader 的完整调用链
限速逻辑必须介入在 http.Response.Body 和目标 io.Writer（如文件）之间。最简路径就是把响应体套一层 limitedReader，再交给 io.Copy。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
容易忽略的是：HTTP 响应体可能被提前关闭（如服务端主动断连），或客户端取消请求，此时限速器的 ReserveN 可能返回 rate.ErrLimited，但这个错误不等于传输失败，要区分处理。
- 务必检查
http.Response.StatusCode，限速不影响状态码校验 - 不要把限速器放在
os.OpenFile后端，写入限速不如读取限速可控（磁盘 IO 不稳定） - 若用
io.CopyBuffer，缓冲区大小会影响单次Read字节数，从而影响限速平滑度；建议保持默认 32KB 或设为 64KB
并发下载时每个 goroutine 必须独占 rate.Limiter
多个下载任务共用同一个 rate.Limiter 会导致总速率被摊薄，且相互干扰。比如两个 goroutine 共享 1MB/s 限速器，每个实际可能只跑 300KB/s，还可能出现某一方突然卡住。
正确做法是每个下载任务初始化自己的 rate.Limiter，哪怕目标速率相同。这是轻量对象，无性能负担。
- 不要全局复用
rate.NewLimiter(...)实例 - 若需动态调整限速（如用户拖动滑块），可暴露
SetLimit方法，但要注意并发安全 ——rate.Limiter的SetLimit是线程安全的 - 测试时用
httptest.Server模拟大文件响应，比真实网络更可控
限速逻辑本身不复杂，难点在于令牌申请时机、错误分类和并发隔离——这三个点没处理好，限速就变成“看起来在限，其实没限住”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
