Golang如何实现文件下载功能_Golang文件下载接口示例-Golang-PHP中文网

Golang如何实现文件下载功能_Golang文件下载接口示例

P粉602998670

发布： 2025-11-26 17:31:02

原创

104人浏览过

Go语言中实现文件下载可通过net/http和os包完成。1. 使用http.ServeFile创建下载接口，设置Content-Disposition响应头触发浏览器下载；2. 通过http.Get获取远程文件响应体，结合os.Create与io.Copy保存到本地；3. 建议添加超时控制、状态码检查、流式读写和User-Agent设置，确保稳定性和兼容性。

golang如何实现文件下载功能_golang文件下载接口示例

在Go语言中实现文件下载功能非常简单，主要依赖标准库中的 net/http 和 os 包。你可以通过创建一个HTTP处理器（Handler），将指定文件返回给客户端，或者从远程URL下载文件并保存到本地。下面分别介绍两种常见场景：提供文件下载接口和主动下载远程文件。

1. 提供文件下载接口（服务端）

如果你想让客户端可以通过访问某个URL来下载服务器上的文件，可以使用 http.ServeFile 方法，它会自动设置必要的响应头（如 Content-Disposition），触发浏览器下载。

示例代码：

package main

import (
    "net/http"
)

func downloadHandler(w http.ResponseWriter, r *http.Request) {
    // 指定要下载的文件路径
    filePath := "./uploads/example.pdf"

    // 设置响应头，提示浏览器下载文件
    w.Header().Set("Content-Disposition", "attachment; filename=example.pdf")
    w.Header().Set("Content-Type", "application/pdf")

    // 使用 ServeFile 发送文件
    http.ServeFile(w, r, filePath)
}

func main() {
    http.HandleFunc("/download", downloadHandler)
    http.ListenAndServe(":8080", nil)
}

登录后复制

访问 http://localhost:8080/download 即可触发文件下载。注意确保文件路径存在且有读取权限。

2. 从远程URL下载文件到本地

如果需要从互联网上下载文件并保存到本地磁盘，可以使用 http.Get 获取响应体，再用 os.Create 写入文件。

豆包AI编程

豆包推出的AI编程助手

1697

查看详情

立即学习“go语言免费学习笔记（深入）”；

示例代码：

package main

import (
    "io"
    "net/http"
    "os"
)

func downloadFileFromURL(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/sample.pdf"
    path := "./sample.pdf"

    err := downloadFileFromURL(url, path)
    if err != nil {
        panic(err)
    }
    println("文件下载完成:", path)
}

登录后复制

这个方法适合用于爬虫、资源抓取或定时同步远程文件等场景。记得处理网络错误和超时情况，生产环境中建议使用带超时的 http.Client。