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

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

P粉602998670

发布： 2025-11-13 15:29:03

原创

945人浏览过

答案：通过Golang实现文件上传下载需处理HTTP请求与文件操作。1. 创建项目结构及upload目录用于存储文件；2. 使用ParseMultipartForm解析表单，读取文件并保存至upload目录；3. 下载时设置Content-Disposition响应头，调用http.ServeFile发送文件；4. 注册/upload、/download/路由并启动服务。前端可通过表单上传，服务端返回下载响应，完整实现基础文件传输功能。

如何在 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 方法解析带有文件的表单数据。

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

上传接口代码示例：

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">
  <input type="file" name="file" />
  <button type="submit">上传</button>
</form>

登录后复制

3. 实现文件下载功能

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

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

代码示例：

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 := `<h3>文件上传</h3><form ... >...</form>`
    fmt.Fprint(w, html)
})

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

登录后复制

}

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

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

以上就是如何在 Golang 中实现文件上传下载功能_Golang 文件服务器实战项目的详细内容，更多请关注php中文网其它相关文章！