使用Golang实现HTTP文件下载需避免内存溢出,小文件可用http.Get配合io.ReadAll和os.WriteFile;大文件应采用流式下载,通过http.Get获取响应后,用io.Copy将resp.Body分块写入由os.Create创建的文件中,确保内存占用恒定;生产环境推荐自定义http.Client设置超时,并通过包装Reader实现进度反馈,结合Content-Length预估大小,支持认证时需手动构造Request并设置Header,禁止复用DefaultClient以防并发问题。

使用Golang实现HTTP文件下载很简单,核心是用http.Get发起请求,再把响应体流式写入本地文件,避免内存爆满。关键在于处理错误、设置超时、校验状态码和进度反馈。
基础下载:GET + ioutil.WriteFile(适合小文件)
适用于几MB以内的文件,代码简洁:
- 调用
http.Get获取响应,检查resp.StatusCode是否为200 - 用
io.ReadAll读取全部响应体(注意:大文件会吃光内存!) - 用
os.WriteFile一次性保存到磁盘
示例:
大小仅1兆左右 ,足够轻便的商城系统; 易部署,上传空间即可用,安全,稳定; 容易操作,登陆后台就可设置装饰网站; 并且使用异步技术处理网站数据,表现更具美感。 前台呈现页面,兼容主流浏览器,DIV+CSS页面设计; 如果您有一定的网页设计基础,还可以进行简易的样式修改,二次开发, 发布新样式,调整网站结构,只需修改css目录中的css.css文件即可。 商城网站完全独立,网站源码随时可供您下载
if err != nil { log.Fatal(err) }
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK { log.Fatal("bad status", resp.Status) }
data, err := io.ReadAll(resp.Body)
if err != nil { log.Fatal(err) }
err = os.WriteFile("file.zip", data, 0644)
流式下载:边读边写(推荐,适合任意大小)
这才是生产环境该用的方式,内存占用恒定(约几十KB),支持GB级文件:
立即学习“go语言免费学习笔记(深入)”;
- 用
os.Create新建文件句柄 - 用
io.Copy把resp.Body直接拷贝到文件,底层自动分块读写 - 记得关闭文件和响应体(
defer f.Close()和defer resp.Body.Close())
示例:
resp, err := http.Get("https://example.com/large.iso")if err != nil { log.Fatal(err) }
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK { log.Fatal("HTTP", resp.StatusCode) }
f, err := os.Create("large.iso")
if err != nil { log.Fatal(err) }
defer f.Close()
n, err := io.Copy(f, resp.Body)
if err != nil { log.Fatal(err) }
log.Printf("downloaded %d bytes", n)
带超时和进度的下载
真实场景需防卡死、要感知进度:
- 用
http.Client自定义Timeout或Context.WithTimeout - 进度统计:包装
resp.Body为自定义Reader,每次Read时更新计数器 - 可结合
fmt.Print("\r%3.1f%%", float64(n)/size*100)做简单终端刷新
小技巧:用resp.Header.Get("Content-Length")获取预估总大小(非强制字段,可能为空)。
下载带认证或自定义Header的文件
比如需要Bearer Token或Cookie:
- 创建
http.Client,手动构造http.Request - 调用
req.Header.Set("Authorization", "Bearer xxx")或req.AddCookie(...) - 用
client.Do(req)发送
注意:不要复用http.DefaultClient在高并发下设Header,应新建Client或用WithCancel Context隔离。
基本上就这些。不复杂但容易忽略错误处理和流控——尤其是大文件千万别用ReadAll。









