Go语言实现文件压缩解压方法

本文深入剖析了Go语言中使用archive/zip进行文件压缩与解压的常见陷阱与最佳实践：从修复因路径分隔符未转义（\→/）和遗漏zipWriter.Close()导致ZIP打不开，到通过filepath.Clean与严格路径前缀校验防御路径穿越攻击；既对比了zip与tar.gz在标准库支持、性能及跨平台兼容性上的取舍，又强调了大文件必须全程流式处理（避免内存暴涨）、及时传播错误并清理残迹的关键原则——帮你写出健壮、安全、高效且真正可用的归档工具。

Go 语言用 archive/zip 压缩文件时，为什么生成的 zip 打不开？

常见原因是没正确设置 zip.FileHeader.Name，或忽略了路径分隔符转换。Windows 下路径是 \，而 ZIP 规范强制要求使用 /。直接写入本地路径会导致解压失败或目录结构错乱。

• 必须将文件路径中的 \ 替换为 /，再赋给 header.Name
• 若压缩的是目录，需手动遍历（filepath.WalkDir），对每个文件调用 zipWriter.CreateHeader
• 别忘了调用 zipWriter.Close() —— 否则 zip 文件末尾缺少 EOCD（End of Central Directory）记录，绝大多数解压工具会报“损坏”

fh, _ := zip.FileInfoHeader(fi)
fh.Name = strings.ReplaceAll(filePath, "\\", "/") // 关键
fh.Name = strings.TrimPrefix(fh.Name, basePath+"/")
w, _ := zw.CreateHeader(fh)
io.Copy(w, f)

解压 zip 到指定目录时，如何防止路径穿越（path traversal）攻击？

用户提供的 zip 包可能包含恶意路径如 ../../../etc/passwd，直接用 header.Name 创建文件会覆盖系统关键位置。必须做白名单校验。

• 用 filepath.Clean(header.Name) 归一化路径
• 检查归一化后路径是否仍以目标解压根目录为前缀（用 strings.HasPrefix + filepath.ToSlash 统一分隔符）
• 拒绝任何含 ".." 或以 "/" 开头的 Name

cleanName := filepath.Clean(header.Name)
if strings.Contains(cleanName, "..") || strings.HasPrefix(cleanName, "/") {
    return fmt.Errorf("illegal path: %s", header.Name)
}
dstPath := filepath.Join(destDir, cleanName)
if !strings.HasPrefix(filepath.ToSlash(dstPath), filepath.ToSlash(destDir)+"/") {
    return fmt.Errorf("escaping from target dir: %s", header.Name)
}

需要同时支持 tar.gz 和 zip，该选 archive/tar 还是第三方库？

Go 标准库已完整支持 archive/tar + compress/gzip 组合，无需引入外部依赖。但要注意：tar 本身不压缩，gzip 是外层封装，解压时要先 gzip.NewReader，再传给 tar.NewReader。

• archive/zip 是单库全功能；archive/tar 必须搭配 compress/* 子包使用
• tar.gz 解压比 zip 略快（无中央目录解析开销），但 zip 支持随机访问单个文件，tar 需顺序扫描
• 若项目需跨平台兼容性（尤其 Windows 用户双击解压），zip 更稳妥；若面向 Linux 服务器批量归档，tar.gz 更轻量

大文件压缩卡住或内存爆掉，怎么流式处理？

别把整个文件读进 []byte 再写入 zip —— 这会让内存占用飙升到文件大小的 2–3 倍。所有操作必须基于 io.Reader / io.Writer 流式完成。

• 压缩时：用 os.Open 获取 *os.File，直接 io.Copy(zipWriter, file)
• 解压时：从 zip.File.Open() 拿到 io.ReadCloser，同样流式写入目标文件
• 对超大文件（>1GB），可加 bufio.Writer 提升写入效率，但注意别在 zip 内部嵌套缓冲（标准库已优化）

真正容易被忽略的是错误传播：流式操作中任一环节出错（如磁盘满、权限不足），必须立刻中断并清理已创建的临时文件，否则留下残缺 zip 或空目录。

本篇关于《Go语言实现文件压缩解压方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！