登录
首页 >  Golang >  Go教程

Golang实现文件上传下载教程

时间：2026-03-02 20:48:55 419浏览 收藏

本文深入浅出地讲解了如何使用 Golang 快速构建一个具备文件上传与下载功能的轻量级 HTTP 文件服务器——从初始化项目结构、自动创建 upload 目录，到利用 ParseMultipartForm 安全解析多部分表单并保存文件，再到通过设置 Content-Disposition 响应头和 http.ServeFile 实现高效文件下载，全程覆盖路由注册、错误处理与基础安全控制，让开发者无需依赖第三方框架即可掌握生产可用的文件传输核心实现。

如何在 Golang 中实现文件上传下载功能_Golang 文件服务器实战项目

在 Golang 中实现文件上传下载功能并不复杂，关键在于理解 HTTP 请求的处理流程以及文件操作的基本方法。下面通过一个简单的文件服务器实战项目，带你一步步实现文件的上传与下载功能。

1. 基础项目结构

我们先构建一个基础的项目目录：

  • main.go # 主程序入口
  • upload/ # 存放上传文件的目录

确保 upload 目录存在，或者在程序启动时自动创建：

func init() {
    if _, err := os.Stat("upload"); os.IsNotExist(err) {
        os.Mkdir("upload", 0755)
    }
}

2. 实现文件上传功能

使用 http.Request 的 ParseMultipartForm 方法解析带有文件的表单数据。

上传接口代码示例：

func handleUpload(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "仅支持 POST 请求", http.StatusMethodNotAllowed)
        return
    }
<pre class="brush:php;toolbar:false;">// 解析 multipart 表单，限制大小为 32MB
err := r.ParseMultipartForm(32 << 20)
if err != nil {
    http.Error(w, "解析表单失败", http.StatusBadRequest)
    return
}

file, handler, err := r.FormFile("file")
if err != nil {
    http.Error(w, "获取文件失败", http.StatusBadRequest)
    return
}
defer file.Close()

// 创建本地文件
dst, err := os.Create(filepath.Join("upload", handler.Filename))
if err != nil {
    http.Error(w, "创建文件失败", http.StatusInternalServerError)
    return
}
defer dst.Close()

// 拷贝文件内容
_, err = io.Copy(dst, file)
if err != nil {
    http.Error(w, "保存文件失败", http.StatusInternalServerError)
    return
}

fmt.Fprintf(w, "文件 %s 上传成功", handler.Filename)

}

前端可以使用简单的 HTML 表单测试：

<form action="/upload" method="post" enctype="multipart/form-data">
  &lt;input type=&quot;file&quot; name=&quot;file&quot; /&gt;
  <button type="submit">上传</button>
</form>

3. 实现文件下载功能

下载功能的核心是设置正确的响应头，触发浏览器下载行为。

代码示例：

func handleDownload(w http.ResponseWriter, r *http.Request) {
    filename := filepath.Base(r.URL.Path[len("/download/"):]) // 获取文件名
    filepath := filepath.Join("upload", filename)
<pre class="brush:php;toolbar:false;">// 检查文件是否存在
if _, err := os.Stat(filepath); os.IsNotExist(err) {
    http.NotFound(w, r)
    return
}

// 设置响应头
w.Header().Set("Content-Disposition", "attachment; filename="+filename)
w.Header().Set("Content-Type", "application/octet-stream")

// 发送文件
http.ServeFile(w, r, filepath)

}

访问 /download/filename.txt 即可触发下载。

4. 路由注册与服务启动

在 main 函数中注册路由并启动 HTTP 服务：

func main() {
    http.HandleFunc("/upload", handleUpload)
    http.HandleFunc("/download/", handleDownload)
<pre class="brush:php;toolbar:false;">// 可选：提供一个上传页面
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    if r.URL.Path != "/" {
        http.NotFound(w, r)
        return
    }
    html := `&lt;h3&gt;文件上传&lt;/h3&gt;&lt;form ... &gt;...&lt;/form&gt;`
    fmt.Fprint(w, html)
})

fmt.Println("服务器启动，端口 :8080")
log.Fatal(http.ListenAndServe(":8080", nil))

}

运行程序后，访问 http://localhost:8080 即可上传文件，上传后的文件可通过 /download/文件名 下载。

基本上就这些。这个小项目涵盖了文件上传下载的核心逻辑，适合学习和快速集成到实际应用中。注意生产环境还需增加权限控制、文件类型校验、防覆盖等安全措施。不复杂但容易忽略细节。

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

golang 文件上传下载
资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>