io.Copy 默认行为不适合大文件下载，因其32KB缓冲区在高延迟网络下易阻塞、无超时取消机制、写入慢时内存暴涨、无法监控进度；需用bufio.Reader自定义缓冲+手动分块读写+context超时控制来提升稳定性与可控性。
直接用 io.Copy 下载大文件基本够用，但默认行为在高延迟或不稳定网络下容易卡住、超时、内存暴涨；真正需要优化的不是“怎么快”，而是“怎么稳”和“怎么可控”。
为什么 io.Copy 默认行为不适合大文件下载
io.Copy 内部使用 32KB 缓冲区（io.DefaultBufSize），对小文件没问题，但遇到以下情况会出问题：
- 网络抖动时，底层
Read可能长时间阻塞，而io.Copy不提供超时或取消机制 - 目标是本地磁盘文件时，若写入慢于读取（如机械硬盘 + 高速网络），缓冲区会堆积，导致内存占用陡增（尤其并发多任务）
- 无法获取实时进度，无法做断点续传或限速
用 bufio.Reader + 自定义 buffer 控制读取节奏
关键不是换函数，而是接管读取粒度和时机。例如在 HTTP 响应体上包一层带超时的 bufio.Reader，并显式控制每次 Read 大小：
resp, err := http.Get("https://example.com/big.zip")
if err != nil {
return err
}
defer resp.Body.Close()
// 设置 1MB 缓冲区，减少系统调用次数，但不过大
bufReader := bufio.NewReaderSize(resp.Body, 1024*1024)
dst, err := os.Create("big.zip")
if err != nil {
return err
}
defer dst.Close()
// 手动分块读写，便于插入逻辑
buf := make([]byte, 64*1024) // 每次读 64KB
for {
n, err := bufReader.Read(buf)
if n > 0 {
if _, writeErr := dst.Write(buf[:n]); writeErr != nil {
return writeErr
}
}
if err == io.EOF {
break
}
if err != nil {
return err
}
}
这样做的好处：可插入选项如 time.AfterFunc 做单次读超时、统计 n 实现进度回调、遇错误立即返回不等完整块。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
加 context.WithTimeout 和 http.Client 超时控制
io.Copy 本身不响应 context.Context，必须把超时逻辑放在源头——HTTP 客户端和读写环节：
- 设置
http.Client.Timeout防止连接/首字节超时 - 用
context.WithTimeout包裹整个下载流程，并在每次Read或Write前检查ctx.Err() - 避免只设
time.Sleep，它不释放 goroutine，要用select+ctx.Done()
示例关键片段：
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Minute)
defer cancel()
req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)
resp, err := http.DefaultClient.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
// 后续读写循环中：
select {
case <-ctx.Done():
return ctx.Err()
default:
}
n, err := reader.Read(buf)
什么时候该用 io.Copy，什么时候该手动读写
看场景是否需要「干预中间过程」：
- 纯管道转发（如代理、日志透传）、无网络风险、文件确定小于 100MB → 直接
io.Copy(dst, src)，简洁可靠 - 需断点续传、限速、进度回调、失败重试、内存敏感（如嵌入设备）→ 必须手动控制
Read/Write，配合bufio.Reader和context - 并发下载多个大文件 → 手动读写 + channel 控制并发数，比一堆
io.Copygoroutine 更易监控和限流
缓冲区大小不是越大越好：超过 OS page size（通常 4KB）后收益递减，但错误时丢失数据更多；推荐 64KB–1MB 区间，视网络 RTT 和磁盘 IOPS 调整。
