Go语言中下载HTTP文件常用net/http包，结合os和io实现。1. 使用http.Get直接获取响应体并io.Copy写入文件，适用于小文件；2. 增加resp.StatusCode检查，确保状态码为200避免保存错误内容；3. 大文件可利用Range头实现断点续传，通过os.OpenFile获取已存在文件大小并发送范围请求；4. 通过自定义ProgressReader包装resp.Body，在Read时触发进度回调，实现实时进度条。根据需求选择方法：简单场景用第一种，生产环境加状态校验，大文件支持续传，用户体验优先则添加进度显示。标准库即可高效完成下载任务。
在Go语言中，下载HTTP文件并保存到本地是一个常见需求，比如获取远程图片、日志文件或配置资源。实现方式多种多样，核心依赖 net/http 包，结合 os 和 io 包完成文件写入。以下是几种常用且实用的方法。
1. 使用 http.Get 简单下载
最基础的方式是使用 http.Get 发起请求，读取响应体，并写入本地文件。
resp, err := http.Get("https://example.com/file.zip")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("file.zip")
if err != nil {
log.Fatal(err)
}
defer file.Close()
_, err = io.Copy(file, resp.Body)
if err != nil {
log.Fatal(err)
}
这种方式简洁明了，适合小文件。注意要始终调用 defer resp.Body.Close() 避免资源泄露。
2. 带错误状态检查的健壮下载
实际开发中需判断HTTP状态码，避免将404或500响应误存为文件。
立即学习“go语言免费学习笔记（深入）”；
resp, err := http.Get("https://example.com/file.zip")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
log.Fatalf("下载失败: %v", resp.Status)
}
file, err := os.Create("file.zip")
if err != nil {
log.Fatal(err)
}
defer file.Close()
_, err = io.Copy(file, resp.Body)
if err != nil {
log.Fatal(err)
}
通过检查 resp.StatusCode 提高程序鲁棒性，防止异常内容被保存。
3. 支持断点续传的分块下载
对于大文件，可结合 Range 请求头实现断点续传。
若文件已存在，先获取其大小，再发起带范围的请求：
file, err := os.OpenFile("file.zip", os.O_RDWR|os.O_CREATE, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
info, _ := file.Stat()
start := info.Size()
req, err := http.NewRequest("GET", "https://example.com/file.zip", nil)
if err != nil {
log.Fatal(err)
}
if start > 0 {
req.Header.Set("Range", fmt.Sprintf("bytes=%d-", start))
}
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode == http.StatusPartialContent || resp.StatusCode == http.StatusOK {
_, err = io.Copy(file, resp.Body)
if err != nil {
log.Fatal(err)
}
} else {
log.Fatalf("服务器不支持断点续传: %v", resp.Status)
}
这种方法能有效恢复中断的下载，节省时间和带宽。
4. 下载时显示进度条
用户友好型程序常需展示下载进度。可通过包装 resp.Body 实现实时统计。
type ProgressReader struct {
io.Reader
Total int64
Current int64
OnProgress func(current, total int64)
}
func (pr *ProgressReader) Read(p []byte) (n int, err error) {
n, err = pr.Reader.Read(p)
pr.Current += int64(n)
if pr.OnProgress != nil {
pr.OnProgress(pr.Current, pr.Total)
}
return
}
使用方式：
resp, _ := http.Get(url)
defer resp.Body.Close()
totalSize := resp.ContentLength
file, _ := os.Create("file.zip")
defer file.Close()
progressReader := &ProgressReader{
Reader: resp.Body,
Total: totalSize,
OnProgress: func(current, total int64) {
fmt.Printf("下载进度: %d/%d (%.2f%%)\n", current, total, float64(current)/float64(total)*100)
},
}
io.Copy(file, progressReader)
这样就能实时看到下载百分比，提升交互体验。
基本上就这些。根据场景选择合适方法：简单下载用第一种，生产环境加状态判断，大文件考虑断点续传，用户体验优先则加上进度反馈。Golang标准库足够强大，无需引入额外依赖即可完成高效文件下载。
