本文详细讲解如何利用 Go 标准库 archive/zip 和 filepath.Walk 实现目录的递归压缩，涵盖路径处理规范、常见陷阱及可直接运行的完整示例代码。
本文详细讲解如何利用 go 标准库 `archive/zip` 和 `filepath.walk` 实现目录的递归压缩，涵盖路径处理规范、常见陷阱及可直接运行的完整示例代码。
在 Go 中压缩一个包含多级子目录和文件的目录，核心在于：正确遍历文件系统 + 合理构造 ZIP 内部路径 + 安全写入数据流。Go 标准库未提供开箱即用的“压缩目录”函数，但 filepath.Walk（递归遍历）与 archive/zip.Writer（构建 ZIP 流）组合即可高效、可靠地完成任务。
关键注意事项（务必遵守）
✅ ZIP 内部路径必须是相对路径，且不能以 / 开头
例如：要将 input/styles/main.css 打包为 ZIP 中的 styles/main.css（而非 /styles/main.css 或 ./styles/main.css）。若传入绝对路径或带前导斜杠，会导致 ZIP 结构异常（如解压后出现冗余根目录或解析失败）。✅ 目录本身无需显式创建
zip.Writer.Create() 只需为文件调用；ZIP 规范通过路径中的 / 自动推导目录层级。因此遍历时跳过目录项（info.IsDir() == true），仅处理普通文件即可。⚠️ filepath.Walk 按字典序遍历，不保证业务所需顺序
某些格式（如 EPUB）虽通常容忍顺序差异，但若需严格控制文件在 ZIP 中的排列（如 mimetype 必须为首个条目），应改用 os.ReadDir + 手动递归 + 排序，而非依赖 Walk。
完整可运行示例
以下代码将当前目录下的 input/ 文件夹完整压缩为 output.zip：
package main
import (
"archive/zip"
"fmt"
"io"
"os"
"path/filepath"
"strings"
)
func main() {
// 创建 ZIP 输出文件
zipFile, err := os.Create("output.zip")
if err != nil {
panic(fmt.Sprintf("failed to create zip file: %v", err))
}
defer zipFile.Close()
// 初始化 ZIP 写入器
zipWriter := zip.NewWriter(zipFile)
defer zipWriter.Close()
// 遍历 input 目录（递归）
err = filepath.Walk("input", func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
}
if info.IsDir() {
return nil // 跳过目录，ZIP 会自动按文件路径生成目录结构
}
// 构造 ZIP 内部相对路径：移除前缀 "input/"，确保无前导 "/"
relPath, err := filepath.Rel("input", path)
if err != nil {
return fmt.Errorf("failed to compute relative path for %s: %w", path, err)
}
// 确保路径分隔符统一为 '/'（ZIP 规范要求）
relPath = strings.ReplaceAll(relPath, "\", "/")
// 创建 ZIP 文件条目
zipFileWriter, err := zipWriter.Create(relPath)
if err != nil {
return fmt.Errorf("failed to create zip entry %s: %w", relPath, err)
}
// 读取源文件并写入 ZIP 条目
srcFile, err := os.Open(path)
if err != nil {
return fmt.Errorf("failed to open source file %s: %w", path, err)
}
defer srcFile.Close()
_, err = io.Copy(zipFileWriter, srcFile)
if err != nil {
return fmt.Errorf("failed to copy content for %s: %w", relPath, err)
}
fmt.Printf("Added: %s → %s
", path, relPath)
return nil
})
if err != nil {
panic(fmt.Sprintf("walk failed: %v", err))
}
// 必须显式调用 Close() 才能写入 ZIP 尾部信息（EOCD）
if err := zipWriter.Close(); err != nil {
panic(fmt.Sprintf("failed to close zip writer: %v", err))
}
fmt.Println("✅ Archive created successfully: output.zip")
}进阶建议
- 错误处理增强：生产环境建议使用 errors.Join 汇总多个错误，或记录具体失败路径。
- 大文件优化：对超大文件，可考虑 io.CopyBuffer 配合自定义 buffer 提升性能。
- 排除规则支持：可在 walker 函数中添加 .gitignore 解析或正则匹配逻辑，跳过临时文件或敏感目录（如 node_modules、.DS_Store）。
- 内存安全：避免一次性加载整个文件到内存——本方案使用流式 io.Copy，天然支持任意大小文件。
遵循以上实践，你就能稳定、高效地在 Go 应用中集成 ZIP 压缩能力，适用于日志归档、API 文件打包、静态资源发布等多种场景。
