本文详细讲解使用 Go 标准库 archive/zip 和 filepath.Walk 实现目录递归压缩的方法，涵盖路径处理规范、常见陷阱及完整可运行示例。
本文详细讲解使用 go 标准库 `archive/zip` 和 `filepath.walk` 实现目录递归压缩的方法，涵盖路径处理规范、常见陷阱及完整可运行示例。
在 Go 中压缩整个目录（含嵌套子目录与文件）是一项常见需求，例如构建打包工具、生成 EPUB 或 ZIP 分发包。Go 标准库提供了轻量高效的 archive/zip 包，配合 filepath.Walk 可轻松实现递归遍历与写入，无需手动实现文件树遍历逻辑。
关键要点：ZIP 路径规范
ZIP 文件中的条目路径必须是相对于 ZIP 根目录的相对路径，且不能以 / 开头。例如：
- 顶层文件 manifest.xml → 应写入 "manifest.xml"
- 子目录下文件 assets/style.css → 应写入 "assets/style.css"（而非 "/assets/style.css" 或 "./assets/style.css"）
若传入绝对路径（如 /home/user/input/file.txt），zip.Writer.Create() 会创建非法条目，解压时可能产生意外目录结构或失败。
Giga Coding Agent
下载
一款AI工具，主要用于通过后台进程运行 Codex CLI、Claude Code、OpenCode 或 Pi Coding Agent，实现程序化控制，适合需要提升相关任务效率的用户。
完整实现示例
以下代码将当前目录下的 input/ 文件夹完整压缩为 output.zip：
package main
import (
"archive/zip"
"fmt"
"io"
"os"
"path/filepath"
)
func main() {
file, err := os.Create("output.zip")
if err != nil {
panic(fmt.Sprintf("无法创建 ZIP 文件: %v", err))
}
defer file.Close()
w := zip.NewWriter(file)
defer func() {
if err := w.Close(); err != nil {
panic(fmt.Sprintf("关闭 ZIP writer 失败: %v", err))
}
}()
err = filepath.Walk("input", func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
}
if info.IsDir() {
return nil // 跳过目录本身，仅处理文件
}
// 将绝对路径转换为 ZIP 根相对路径（关键！）
// 假设源目录为 "input"，需截取 path 中 "input/" 后的部分
zipPath, err := filepath.Rel("input", path)
if err != nil {
return fmt.Errorf("计算 ZIP 路径失败 %s: %w", path, err)
}
// 创建 ZIP 条目（自动处理目录层级）
fw, err := w.Create(zipPath)
if err != nil {
return fmt.Errorf("创建 ZIP 条目 %s 失败: %w", zipPath, err)
}
// 读取并写入文件内容
f, err := os.Open(path)
if err != nil {
return fmt.Errorf("打开源文件 %s 失败: %w", path, err)
}
defer f.Close()
if _, err := io.Copy(fw, f); err != nil {
return fmt.Errorf("复制文件内容到 ZIP 失败 %s: %w", zipPath, err)
}
fmt.Printf("已添加: %s → %s\n", path, zipPath)
return nil
})
if err != nil {
panic(fmt.Sprintf("遍历目录失败: %v", err))
}
}
注意事项与最佳实践
- ✅ 始终使用 filepath.Rel() 计算 ZIP 内路径：避免硬编码或依赖当前工作目录，确保路径安全、可移植。
- ⚠️ filepath.Walk 按字典序遍历，若协议要求特定顺序（如 EPUB 规范中 mimetype 必须为首个条目），应改用 os.ReadDir + 手动排序（逐层 Sort 后递归）。
- ? 不要忽略 w.Close()：它负责写入 ZIP 中央目录，遗漏将导致 ZIP 文件损坏。建议用 defer 或显式 Close() 并检查错误。
- ? 生产环境建议增加校验：压缩前验证源目录存在、目标 ZIP 可写；压缩后可用 unzip -t output.zip 简单验证完整性。
通过以上方法，你可稳健、高效地在 Go 中实现任意深度目录的 ZIP 打包，兼顾标准兼容性与工程健壮性。
