首页 > Golang > Go教程

Golang下载文件方法全解析

时间：2025-11-28 11:57:33 497浏览收藏

小伙伴们有没有觉得学习Golang很有意思？有意思就对了！今天就给大家带来《Golang下载文件方法详解》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

Go语言中下载HTTP文件常用net/http包，结合os和io实现。1. 使用http.Get直接获取响应体并io.Copy写入文件，适用于小文件；2. 增加resp.StatusCode检查，确保状态码为200避免保存错误内容；3. 大文件可利用Range头实现断点续传，通过os.OpenFile获取已存在文件大小并发送范围请求；4. 通过自定义ProgressReader包装resp.Body，在Read时触发进度回调，实现实时进度条。根据需求选择方法：简单场景用第一种，生产环境加状态校验，大文件支持续传，用户体验优先则添加进度显示。标准库即可高效完成下载任务。

Golang如何下载文件并保存_Golang HTTP文件下载方法总结

在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响应误存为文件。

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标准库足够强大，无需引入额外依赖即可完成高效文件下载。

好了，本文到此结束，带大家了解了《Golang下载文件方法全解析》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！