当前位置：首页 > Go > 正文

Go语言实现文件上传（基于gin框架的完整教程）

主机测评网
Go
2025-12-09
581

在现代Web开发中，文件上传是一个非常常见的功能。使用Go语言结合流行的Web框架gin，我们可以快速、安全地实现这一功能。本教程将手把手教你如何使用gin框架上传文件，即使是编程新手也能轻松上手。

Go语言实现文件上传（基于gin框架的完整教程） Go语言文件上传 gin框架上传文件 Go Web开发文件上传教程第1张

准备工作

首先，确保你已经安装了Go语言环境（建议1.16以上版本）。然后，通过以下命令初始化一个新项目并安装gin框架：

# 初始化模块go mod init upload-demo# 安装gingo get -u github.com/gin-gonic/gin

创建基础Web服务器

我们先创建一个最简单的gin服务器，用于后续添加文件上传功能：

package mainimport (	"github.com/gin-gonic/gin")func main() {	r := gin.Default()	r.GET("/", func(c *gin.Context) {		c.String(200, "Hello, 文件上传服务已启动！")	})	r.Run(":8080")}

实现单文件上传

接下来，我们添加一个POST路由来处理文件上传。在gin中，可以使用c.FormFile("file")方法获取上传的文件：

package mainimport (	"fmt"	"net/http"	"os"	"github.com/gin-gonic/gin")func main() {	r := gin.Default()	// 设置最大上传大小为10MB	r.MaxMultipartMemory = 10 << 20 // 10 MiB	r.POST("/upload", func(c *gin.Context) {		// 获取上传的文件		file, err := c.FormFile("file")		if err != nil {			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})			return		}		// 创建保存目录（如果不存在）		if _, err := os.Stat("./uploads"); os.IsNotExist(err) {			os.MkdirAll("./uploads", os.ModePerm)		}		// 保存文件到本地		savePath := fmt.Sprintf("./uploads/%s", file.Filename)		if err := c.SaveUploadedFile(file, savePath); err != nil {			c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})			return		}		c.JSON(http.StatusOK, gin.H{			"message": "文件上传成功",			"filename": file.Filename,			"size":     file.Size,		})	})	r.Run(":8080")}

前端HTML表单测试

为了方便测试，我们可以创建一个简单的HTML页面用于上传文件：

<!DOCTYPE html><html lang="zh-CN"><head>    <meta charset="UTF-8">    <title>文件上传测试</title></head><body>    <h2>Go语言文件上传测试</h2>    <form action="http://localhost:8080/upload" method="post" enctype="multipart/form-data">        <input type="file" name="file" required />        <button type="submit">上传文件</button>    </form></body></html>

多文件上传支持

如果你需要同时上传多个文件，gin也提供了便利的方法。只需使用c.MultipartForm()即可：

r.POST("/upload-multiple", func(c *gin.Context) {	form, _ := c.MultipartForm()	files := form.File["files"] // 注意：前端input的name应为files[]	var filenames []string	for _, file := range files {		savePath := fmt.Sprintf("./uploads/%s", file.Filename)		if err := c.SaveUploadedFile(file, savePath); err != nil {			c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})			return		}		filenames = append(filenames, file.Filename)	}	c.JSON(http.StatusOK, gin.H{		"message":   "多文件上传成功",		"filenames": filenames,	})})