使用Golang实现ZIP压缩下载功能，通过net/http和archive/zip包将文件流式写入HTTP响应。示例代码创建HTTP处理器，设置Content-Disposition头触发下载，利用zip.Writer直接压缩多个文件并推送到客户端，避免临时文件生成。关键点包括流式压缩、响应头配置、错误处理与资源释放。支持动态文件列表、目录递归、大文件限流等扩展，适用于API或后台系统集成。
在 Web 服务开发中，经常需要将多个文件打包压缩后提供给用户下载。Golang 凭借其高效的并发处理和标准库支持，非常适合实现文件压缩与网络传输一体化的功能。本文介绍如何使用 Golang 实现将指定文件压缩为 ZIP 格式，并通过 HTTP 直接推送给客户端下载。
使用 net/http 和 archive/zip 实现压缩下载
Go 的 archive/zip 包可以创建 ZIP 压缩流，结合 net/http 可以直接将压缩数据写入 HTTP 响应体，无需临时文件，节省磁盘 I/O。
以下是一个完整示例：
package main
import (
"archive/zip"
"io"
"net/http"
"os"
)
func downloadZipHandler(w http.ResponseWriter, r *http.Request) {
// 设置响应头，触发浏览器下载
w.Header().Set("Content-Type", "application/zip")
w.Header().Set("Content-Disposition", `attachment; filename="files.zip"`)
// 创建 zip writer，直接写入 HTTP 响应
zipWriter := zip.NewWriter(w)
defer zipWriter.Close()
// 要压缩的文件列表
files := []string{"file1.txt", "file2.log", "config.json"}
for _, fileName := range files {
file, err := os.Open(fileName)
if err != nil {
http.Error(w, "无法打开文件: "+fileName, http.StatusInternalServerError)
return
}
defer file.Close()
// 获取文件信息，保留原始文件名
fileInfo, err := file.Stat()
if err != nil {
http.Error(w, "无法读取文件信息: "+fileName, http.StatusInternalServerError)
return
}
// 在 ZIP 中创建对应文件头
fileHeader, err := zip.FileInfoHeader(fileInfo)
if err != nil {
http.Error(w, "创建文件头失败", http.StatusInternalServerError)
return
}
fileHeader.Name = fileName // 保持原始文件名
fileHeader.Method = zip.Deflate
// 创建 ZIP 中的文件写入器
writer, err := zipWriter.CreateHeader(fileHeader)
if err != nil {
http.Error(w, "创建压缩条目失败", http.StatusInternalServerError)
return
}
// 将文件内容拷贝到压缩流
_, err = io.Copy(writer, file)
if err != nil {
http.Error(w, "写入压缩数据失败", http.StatusInternalServerError)
return
}
}
}
func main() {
http.HandleFunc("/download", downloadZipHandler)
http.ListenAndServe(":8080", nil)
}关键细节说明
实现过程中有几个关键点需要注意，确保功能稳定且用户体验良好。
立即学习“go语言免费学习笔记（深入）”；
-
流式压缩：通过将
*http.ResponseWriter直接传给zip.NewWriter，实现边压缩边发送，避免内存或磁盘溢出。 -
响应头设置：
Content-Disposition: attachment是关键，它告诉浏览器这是下载请求，而不是展示内容。 - 错误处理：每个文件操作都应检查错误，一旦出错立即返回 HTTP 错误码，防止 ZIP 结构损坏。
-
资源释放：使用
defer file.Close()确保文件句柄及时关闭，但注意循环中 defer 的使用需谨慎（本例无问题，因函数结束才执行）。
优化建议与扩展场景
实际项目中可能需要更灵活的控制。
- 动态文件列表：可从数据库或请求参数获取要压缩的文件路径。
-
目录递归压缩：遍历目录时使用
filepath.Walk，注意在 ZIP 中维护相对路径。 - 大文件限流：对特别大的文件，可加入限速或分块压缩逻辑。
- 内存缓冲：若担心阻塞主线程，可在 goroutine 中处理压缩，配合 channel 控制。
基本上就这些。Golang 的标准库足够强大，几行代码就能实现一个高效、低开销的压缩下载服务，适合集成进 API 或管理后台。
