Go下载文件核心是安全可控地搬运HTTP字节流:基础用http.Get+io.Copy流式写入;生产需自定义超时client;支持Range断点续传;可加TeeReader实现进度显示。

使用 Go 的 net/http 包下载文件非常直接,核心是发起 HTTP GET 请求,读取响应体,并写入本地文件。关键在于正确处理连接、错误、大文件流式写入,以及可选的进度反馈和重试逻辑。
基础下载:GET 请求 + 文件写入
最简方式是用 http.Get 获取响应,再用 io.Copy 将响应体(resp.Body)流式写入打开的文件。这种方式内存友好,不把整个文件加载进内存。
- 务必检查
resp.StatusCode,避免静默下载错误页(如 404、500) - 使用
defer resp.Body.Close()防止连接泄漏 - 用
os.Create创建文件,注意处理路径不存在的情况(可用os.MkdirAll预创建目录)
带超时与自定义客户端的健壮下载
http.Get 使用默认客户端,无法设置超时或重试。生产环境应构造带超时的 http.Client:
- 设置
Timeout防止请求无限挂起(建议 30 秒以内) - 可选配置
Transport控制最大连接数、空闲连接超时等 - 手动调用
client.Do(req)而非http.Get,便于添加请求头(如 User-Agent、认证 Token)
支持断点续传(Range 请求)
若需支持中断后继续下载,需利用 HTTP Range 头。步骤如下:
立即学习“go语言免费学习笔记(深入)”;
- 先检查本地文件是否存在且非空,获取已下载字节数(
file.Stat().Size()) - 构造请求,添加头:
req.Header.Set("Range", fmt.Sprintf("bytes=%d-", downloaded)) - 发送请求后检查状态码是否为
206 Partial Content - 以
os.OpenFile(..., os.O_WRONLY|os.O_APPEND)方式打开文件追加写入
简单进度显示(适合命令行工具)
对大文件,用户常关心下载进度。可在写入文件时统计已写入字节数:
- 用
io.TeeReader(resp.Body, progressWriter)或自定义io.Reader包装器,在每次Read后更新计数 - 结合
fmt.Printf("\r%v / %v bytes", done, total)实现覆盖式刷新(注意判断resp.ContentLength是否 > 0) - 避免高频刷新(如每 KB 打印一次),可用计时器节流
io.Copy 到断点续传,都是围绕这个核心展开。










