本文介绍使用 io.Copy 将 HTTP 响应等 io.ReadCloser 数据流高效、低内存开销地写入本地文件的最佳实践，涵盖标准用法、性能原理与关键注意事项。
本文介绍使用 `io.copy` 将 http 响应等 `io.readcloser` 数据流高效、低内存开销地写入本地文件的最佳实践，涵盖标准用法、性能原理与关键注意事项。
在 Go 中，将网络响应（如 http.Response.Body）持久化到磁盘是最常见的 I/O 场景之一。核心诉求是：零中间缓冲、最小内存占用、代码简洁可维护、兼顾 CPU 效率。io.Copy 正是为此场景量身定制的标准库函数——它专为在两个 io.Reader 和 io.Writer 之间高效流式传输数据而设计，无需手动管理缓冲区或循环读写。
以下是最简且最优的实现方式：
outFile, err := os.Create("output.bin")
if err != nil {
log.Fatal("failed to create file:", err)
}
defer outFile.Close()
// 流式复制，自动处理分块读写
_, err = io.Copy(outFile, res.Body) // res.Body 是 io.ReadCloser
if err != nil {
log.Fatal("failed to copy response body:", err)
}✅ 为什么这是最高效的？
- io.Copy 内部采用 32 KiB 固定缓冲区（见 io.go#L340），在内存占用（避免大 buffer）与系统调用次数（避免过小 chunk）之间取得最佳平衡；
- 若任一端实现了 WriterTo 或 ReaderFrom 接口（如 *os.File 支持 WriteTo），io.Copy 会自动委托底层 syscall（如 sendfile），实现零拷贝传输（本例中暂不触发，但设计已预留优化路径）；
- 无额外 goroutine、无显式循环、无错误重复检查，逻辑扁平，可读性与性能兼得。
⚠️ 关键注意事项：
- 务必在 io.Copy 前调用 defer outFile.Close()，但不能 defer res.Body.Close() —— 否则可能提前关闭流导致复制中断；正确做法是在 io.Copy 完成后显式关闭：res.Body.Close()；
- 若需校验写入完整性（如对比 Content-Length），应捕获 io.Copy 返回的字节数并与预期比对；
- 对于超大文件或高可靠性场景，建议结合 os.O_CREATE | os.O_WRONLY | os.O_TRUNC 标志创建文件，并考虑使用 fsync（通过 outFile.Sync()）确保落盘，但会牺牲部分吞吐量。
综上，io.Copy 不仅是 Go 官方推荐的标准模式，更是经过深度优化的工程实践。放弃自定义缓冲循环，信任标准库——这是写出高效、稳健、可维护 Go I/O 代码的第一准则。
