Go用archive/zip压缩文件打不开，主因是header.Name未转义路径分隔符（需将\替换为/）、未调用zipWriter.Close()致EOCD缺失；解压时须用filepath.Clean校验路径防穿越；大文件需流式处理避免内存溢出。
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 流式完成。
立即学习“go语言免费学习笔记（深入）”；
- 压缩时：用
os.Open获取*os.File，直接io.Copy(zipWriter, file) - 解压时：从
zip.File.Open()拿到io.ReadCloser，同样流式写入目标文件 - 对超大文件（>1GB），可加
bufio.Writer提升写入效率，但注意别在 zip 内部嵌套缓冲（标准库已优化）
真正容易被忽略的是错误传播：流式操作中任一环节出错（如磁盘满、权限不足），必须立刻中断并清理已创建的临时文件，否则留下残缺 zip 或空目录。
