archive/zip包需手动处理路径净化与Close()调用:必须用filepath.Rel和ToSlash生成ZIP内路径,拒绝含..或/开头的路径;解压前须Clean并校验不逃逸;Close()不可省略,否则中央目录缺失导致ZIP无效。

archive/zip包能直接完成 ZIP 打包与解压,但不自动处理目录递归、路径安全或 UTF-8 兼容性 —— 这些都得手动补全,否则生成的 ZIP 在 Windows/macOS 上打不开,或解压时写入任意路径。
压缩多个文件到 ZIP 时路径必须净化
传给 zip.FileHeader.Name 的值不是磁盘路径,而是 ZIP 内部路径。常见错误是直接用 filepath.Abs() 或保留 ./ 前缀,导致解压后多出冗余层级,甚至触发路径穿越漏洞。
- 用
filepath.Rel(baseDir, fullPath)获取相对路径,再统一转为正斜杠:filepath.ToSlash(relPath) - 拒绝空名、以
/开头、含..的路径,否则部分解压工具(如 macOS 归档实用工具)会静默失败 - 对每个文件调用
header.SetModTime(info.ModTime()),避免解压后时间戳为 Unix 零点,影响构建缓存判断 - 务必设
header.Method = zip.Deflate,否则默认为无压缩(Store),体积不会减小
解压 ZIP 必须校验每个条目路径
直接拼接 zip.File.Name 和目标目录是严重安全隐患。攻击者可构造 ../../../etc/shadow 类似路径,覆盖系统关键文件。
- 先用
strings.ReplaceAll(file.Name, "\", "/")统一路径分隔符 - 用
filepath.Clean()归一化,再检查是否仍含".."或以"/"开头 - 解压前确保
filepath.Join(destDir, cleanName)不会逃逸出destDir—— 可用strings.HasPrefix(filepath.Dir(cleanName), "..")快速拦截 - 创建父目录用
os.MkdirAll(filepath.Dir(filePath), 0755),别漏掉filepath.Dir()
zip.Writer.Close() 不只是收尾,它写中央目录
忘记调用 zipWriter.Close() 是 ZIP 打不开的最常见原因。此时文件看似写入成功,但 ZIP 中央目录结构缺失,解压工具读不到文件列表,报错 invalid zip file 或 not a valid zip file。
- 不能只靠
defer writer.Close()—— 如果中间 panic,defer 可能不执行;建议显式调用并检查返回 err -
Close()会 flush 缓冲区、写入中央目录、计算全局校验和;缺一不可 - 若压缩后要立即读取(比如 HTTP 返回),需在
Close()后再调用outFile.Seek(0, 0),否则指针在末尾
内存中打包 ZIP 要用 bytes.Buffer + zip.Writer
Web 服务返回 ZIP 时,通常不落地文件,而是构建在内存中直接响应。这时不能用 os.Create(),而要用 bytes.Buffer 作为底层 writer。
- 初始化
buf := &bytes.Buffer{},再传给zip.NewWriter(buf) - 添加文件逻辑不变,但内容来源可以是
strings.NewReader("hello")或bytes.NewReader(data) - 最后必须调用
writer.Close(),然后用buf.Bytes()获取完整 ZIP 字节流 - 注意:如果数据量大(>100MB),别全塞内存,改用临时文件或流式响应
真正容易被忽略的是路径净化与 Close() 的双重约束:一个漏判可能让 ZIP 在某些系统上完全不可用,另一个遗漏会让整个归档结构损坏 —— 它们不是“可选优化”,而是 ZIP 格式规范强制要求的底线。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











