使用io.Copy实现文件流式传输，避免内存溢出，结合缓冲区优化性能，并支持断点续传与客户端流式上传。
在Golang中实现文件流式传输，关键在于避免将整个文件加载到内存中，而是通过缓冲区逐块读取和发送数据。这种方式特别适合大文件传输，既能节省内存，又能提升性能和响应速度。
使用io.Copy进行高效流式传输
Go标准库中的 io.Copy 函数是实现流式传输的核心工具。它从一个 io.Reader 读取数据，并写入 io.Writer，自动处理分块读写，无需手动管理缓冲区大小。
以下是一个基于HTTP服务的文件流式下载示例：
package main
import (
"net/http"
"os"
)
func downloadHandler(w http.ResponseWriter, r *http.Request) {
file, err := os.Open("largefile.zip")
if err != nil {
http.Error(w, "File not found", http.StatusNotFound)
return
}
defer file.Close()
// 设置响应头
w.Header().Set("Content-Disposition", "attachment; filename=largefile.zip")
w.Header().Set("Content-Type", "application/octet-stream")
// 流式传输文件
_, err = io.Copy(w, file)
if err != nil {
// 注意：此时可能已开始写入响应体，错误处理需谨慎
return
}
}
控制缓冲区大小以优化性能
虽然 io.Copy 使用默认缓冲区（通常32KB），但你可以通过自定义 io.CopyBuffer 或使用带缓冲的 bufio.Reader 来控制内存使用和吞吐量。
立即学习“go语言免费学习笔记（深入）”；
例如，在网络传输中适当增大缓冲区可减少系统调用次数：
bufferedFile := bufio.NewReaderSize(file, 64*1024) // 64KB缓冲 _, err := io.Copy(w, bufferedFile)
根据实际场景测试不同缓冲区大小对性能的影响，一般32KB~128KB为常见选择。
支持断点续传的流式传输
为了支持客户端断点下载，需要解析请求头中的 Range 字段，并返回对应的数据片段。
基本思路如下：
- 检查请求是否包含
Range: bytes=0-1023类似字段 - 获取文件总大小，计算起始和结束位置
- 使用
file.Seek(offset, 0)跳转到指定位置 - 设置响应状态码为
206 Partial Content - 设置
Content-Range响应头 - 仅传输指定范围的数据
也可以直接使用 Go 内置的 http.ServeContent，它自动处理 Range 请求：
fi, _ := file.Stat() http.ServeContent(w, r, "filename.zip", fi.ModTime(), file)
客户端流式上传文件
在客户端向服务器上传大文件时，也应采用流式方式避免内存溢出。
使用 multipart.Writer 边读边写：
file, _ := os.Open("largefile.zip")
defer file.Close()
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("upload", "largefile.zip")
_, err := io.Copy(part, file)
if err != nil {
// 处理错误
}
writer.Close()
req, _ := http.NewRequest("POST", "http://example.com/upload", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
client := &http.Client{}
client.Do(req)
基本上就这些。掌握 io.Copy、合理使用缓冲、配合HTTP协议特性，就能在Go中高效实现各种场景下的文件流式传输。不复杂但容易忽略细节，比如错误处理和头部设置。
