登录
首页 >  Golang >  Go教程

Golang实现文件下载方法详解

时间:2026-05-16 20:54:16 221浏览 收藏

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

Golang如何实现文件下载功能

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

发送HTTP请求并保存文件

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

示例代码:

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

// 将响应体内容复制到文件
_, err = io.Copy(out, resp.Body)
return err</code>

}

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
}
<p>func (pw *progressWriter) Write(p []byte) (int, error) {
pw.total += int64(len(p))
log.Printf("已下载: %d 字节", pw.total)
return len(p), nil
}
</p>

使用时替换 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)")
<p>resp, err := client.Do(req)
</p>

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

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

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>