go 文件下载需流式读写防内存溢出，支持 Range 断点续传（206响应），用临时文件+重命名保安全，可选校验与超时控制。
Go 语言实现文件下载功能，关键在于合理使用 http 客户端、分块读写、支持 Range 请求头，并持久化记录已下载偏移量。大文件和断点续传不是靠“一次性读完再写”，而是靠“边拉边存 + 断点状态管理”。
1. 基础下载：流式读取避免内存溢出
不把整个响应体加载进内存，而是用 io.copy 或带缓冲的 io.CopyN 直接写入文件：
- 创建目标文件（
os.O_CREATE | os.O_WRONLY | os.O_TRUNC） - 发起 GET 请求，检查状态码是否为 200
- 用
io.Copy(dst, resp.Body)流式写入，不缓存全文 - 关闭
resp.Body和文件句柄（建议用defer）
2. 支持断点续传：利用 Range 头 + 已下载长度
服务端需支持 Accept-Ranges: bytes（绝大多数静态服务器默认支持）。客户端逻辑如下：
- 先检查本地文件是否存在；若存在，用
os.Stat获取已写入字节数done - 构造请求头：
req.Header.Set("Range", fmt.Sprintf("bytes=%d-", done)) - 发送请求，检查响应状态码是否为
206 Partial Content - 以
os.O_WRONLY | os.O_appEND模式打开文件，从末尾追加写入
3. 安全可靠的文件写入与校验
避免写入中途失败导致文件损坏：
立即学习“go语言免费学习笔记（深入）”；
- 下载时先写入临时文件（如
file.zip.part），完成后再os.Rename替换原文件 - 可选：下载完成后计算 SHA256/MD5 并比对服务端提供的
Content-MD5或自定义 header - 对大文件，建议设置
http.Client.Timeout和Transport.MaxIdleConnsPerHost防连接耗尽
4. 简单封装一个可恢复下载器
核心结构体示例：
type Downloader struct { Client *http.Client Path string // 本地保存路径 } func (d *Downloader) Download(url string) error { fi, err := os.Stat(d.Path) var done int64 = 0 if err == nil { done = fi.Size() } req, _ := http.NewRequest("GET", url, nil) if done > 0 { req.Header.Set("Range", fmt.Sprintf("bytes=%d-", done)) } resp, err := d.Client.Do(req) if err != nil { return err } defer resp.Body.Close() if done == 0 && resp.StatusCode != http.StatusOK { return fmt.Errorf("expected 200, got %d", resp.StatusCode) } if done > 0 && resp.StatusCode != http.StatusPartialContent { return fmt.Errorf("expected 206, got %d", resp.StatusCode) } f, _ := os.OpenFile(d.Path, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644) defer f.Close() _, err = io.Copy(f, resp.Body) return err }