Golang实现文件下载方法详解

本文详细介绍了如何使用Go语言标准库（net/http和os）高效、安全地实现文件下载功能，重点强调了流式写入（io.Copy）以避免大文件导致的内存溢出问题，并提供了添加实时进度提示、设置HTTP超时与User-Agent等生产级优化技巧，帮助开发者快速构建稳定可靠的下载逻辑。

在Go语言中实现文件下载功能非常直接，主要依赖标准库中的 net/http 和 os 包。核心思路是发起HTTP GET请求获取远程文件内容，并将响应体流式写入本地文件，避免内存溢出。

发送HTTP请求并保存文件

使用 http.Get 获取远程文件的响应，然后通过 os.Create 创建本地文件，最后用 io.Copy 将响应体数据写入磁盘。

package main
import (
"io"
"net/http"
"os"
)
func downloadFile(url, filepath string) error {
// 发起GET请求
resp, err := http.Get(url)
if err != nil {
return err
}
defer resp.Body.Close()
// 创建本地文件
out, err := os.Create(filepath)
if err != nil {
    return err
}
defer out.Close()

// 将响应体内容复制到文件
_, err = io.Copy(out, resp.Body)
return err
}
func main() {
url := "https://example.com/file.pdf"
err := downloadFile(url, "./file.pdf")
if err != nil {
panic(err)
}
}

添加进度提示（可选）

对于大文件，可以自定义 io.Writer 来监控下载进度，实时输出已下载字节数。

例如，创建一个带计数功能的结构体：

type progressWriter struct {
    total int64
}
func (pw *progressWriter) Write(p []byte) (int, error) {
pw.total += int64(len(p))
log.Printf("已下载: %d 字节", pw.total)
return len(p), nil
}

使用时替换 io.Copy 的目标：

pw := &progressWriter{}
_, err = io.Copy(io.MultiWriter(out, pw), resp.Body)

设置超时和用户代理（推荐）

生产环境中建议使用自定义的 http.Client，设置超时时间与User-Agent，避免被服务器拒绝。

client := &http.Client{
    Timeout: 30 * time.Second,
}
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("User-Agent", "Mozilla/5.0 (compatible; Go-Downloader)")
resp, err := client.Do(req)

基本上就这些。Go的标准库足够完成稳定、高效的文件下载，关键是流式写入避免内存问题，再根据需要增强健壮性和用户体验。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。