Golang实现文件上传下载教程

对于一个Golang开发者来说，牢固扎实的基础是十分重要的，golang学习网就来带大家一点点的掌握基础知识点。今天本篇文章带大家了解《Golang实现文件上传下载功能方法》，主要介绍了，希望对大家的知识积累有所帮助，快点收藏起来吧，否则需要时就找不到了！

答案：Golang通过net/http和os库实现文件上传下载。上传时解析multipart/form-data，保存文件至服务器；下载时设置响应头触发浏览器下载，安全措施包括验证文件类型、限制大小、重命名、鉴权及缓冲读写。

在Golang中实现文件上传与下载功能并不复杂，主要依赖标准库net/http和os。通过合理处理HTTP请求与响应，可以轻松构建安全高效的文件传输服务。

文件上传实现方法

文件上传通常通过HTML表单提交，后端使用http.Request解析multipart/form-data格式的数据。

关键步骤：

- 使用request.ParseMultipartForm(maxMemory)解析表单数据- 调用request.FormFile("file")获取上传的文件句柄- 使用io.Copy将文件内容写入服务器本地路径- 返回上传结果给客户端

示例代码：

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "仅支持POST请求", http.StatusMethodNotAllowed)
        return
    }
// 解析表单，限制内存使用10MB
err := r.ParseMultipartForm(10 << 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("./uploads/" + 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
}

w.Write([]byte("文件上传成功"))
}

文件下载实现方法

文件下载的核心是设置正确的响应头，并将文件内容写入响应体。

关键点：

- 使用os.Open打开目标文件- 设置Content-Disposition头以触发浏览器下载- 设置Content-Type为application/octet-stream- 使用io.Copy将文件流写入响应

示例代码：

func downloadHandler(w http.ResponseWriter, r *http.Request) {
    filename := r.URL.Query().Get("file")
    if filename == "" {
        http.Error(w, "缺少文件名参数", http.StatusBadRequest)
        return
    }
filepath := "./uploads/" + filename
file, err := os.Open(filepath)
if err != nil {
    http.Error(w, "文件不存在", http.StatusNotFound)
    return
}
defer file.Close()

// 获取文件信息
fileInfo, _ := file.Stat()
w.Header().Set("Content-Disposition", "attachment; filename="+filename)
w.Header().Set("Content-Type", "application/octet-stream")
w.Header().Set("Content-Length", fmt.Sprintf("%d", fileInfo.Size()))

// 发送文件
_, err = io.Copy(w, file)
if err != nil {
    http.Error(w, "发送文件失败", http.StatusInternalServerError)
    return
}
}

安全与优化建议

实际项目中需考虑安全性与稳定性。

- 验证文件类型（如检查magic number），防止恶意文件上传- 限制文件大小，避免占用过多服务器资源- 对上传文件重命名，防止路径遍历攻击- 添加身份验证机制，控制访问权限- 使用缓冲读写大文件，避免内存溢出

基本上就这些。只要掌握HTTP协议的基本交互方式，结合Go语言简洁的IO操作，就能快速实现稳定的文件上传下载功能。注意边界情况处理和安全防护，才能用于生产环境。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~