Golang文件上传下载功能实现教程-Golang-PHP中文网

Golang文件上传下载功能实现教程

P粉602998670

发布： 2025-09-02 10:22:01

原创

449人浏览过

使用Go的net/http包解析multipart/form-data格式上传文件；2. 通过ParseMultipartForm和FormFile获取文件句柄；3. 利用os.Create和io.Copy将文件保存到本地；4. 设置内存限制防止过大文件占用资源。

golang文件上传下载功能实现教程

实现文件上传和下载功能是Web开发中的常见需求。Golang凭借其简洁的语法和高效的性能，非常适合用来构建这类服务。下面介绍如何使用标准库快速实现文件的上传与下载功能。

文件上传功能实现

Go的net/http包提供了处理HTTP请求的能力，结合multipart/form-data格式，可以轻松接收客户端上传的文件。

关键步骤如下：

使用http.PostFormFile或在request中调用ParseMultipartForm解析上传数据
通过request.FormFile("file")获取上传的文件句柄
使用os.Create创建本地文件，并用io.Copy将上传内容写入磁盘
设置内存限制（如32 表示32MB）防止过大文件耗尽内存

示例代码片段：

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

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "仅支持POST请求", http.StatusMethodNotAllowed)
        return
    }

    // 解析 multipart 表单，限制内存使用
    r.ParseMultipartForm(32 << 20)
    file, handler, err := r.FormFile("uploadFile")
    if err != nil {
        http.Error(w, "无法获取文件", http.StatusBadRequest)
        return
    }
    defer file.Close()

    // 创建本地文件
    dst, err := os.Create("./uploads/" + handler.Filename)
    if err != nil {
        http.Error(w, "无法创建文件", http.StatusInternalServerError)
        return
    }
    defer dst.Close()

    // 复制文件内容
    io.Copy(dst, file)
    fmt.Fprintf(w, "文件 %s 上传成功", handler.Filename)
}

登录后复制

文件下载功能实现

下载功能的核心是告知浏览器返回的是文件内容，而不是普通文本。通过设置响应头中的Content-Disposition字段，触发浏览器下载行为。

ShopEx助理

一个类似淘宝助理、ebay助理的客户端程序，用来方便的在本地处理商店数据，并能够在本地商店、网上商店和第三方平台之间实现数据上传下载功能的工具。功能说明如下：1.连接本地商店：您可以使用ShopEx助理连接一个本地安装的商店系统，这样就可以使用助理对本地商店的商品数据进行编辑等操作，并且数据也将存放在本地商店数据库中。默认是选择“本地未安装商店”，本地还未安

查看详情

实现要点：

使用os.Open打开服务器上的文件
设置响应头：Content-Disposition: attachment; filename="xxx"
设置Content-Type为application/octet-stream表示二进制流
使用http.ServeFile直接将文件写入响应

示例代码：

func downloadHandler(w http.ResponseWriter, r *http.Request) {
    filename := r.URL.Query().Get("f")
    if filename == "" {
        http.Error(w, "缺少文件名参数", http.StatusBadRequest)
        return
    }

    filepath := "./uploads/" + filename
    _, err := os.Stat(filepath)
    if os.IsNotExist(err) {
        http.Error(w, "文件不存在", http.StatusNotFound)
        return
    }

    w.Header().Set("Content-Disposition", "attachment; filename="+filename)
    w.Header().Set("Content-Type", "application/octet-stream")
    http.ServeFile(w, r, filepath)
}

登录后复制