Go标准库流式ZIP打包需调用zip.Writer.Close()写入EOCD记录，否则ZIP非法；路径须clean并校验防越界；小文件或已压缩格式应设Method=zip.Store避免无效压缩。
Go 标准库完全支持流式多文件 ZIP 打包并直接响应下载，无需临时文件，但 w.Close() 必须调用，否则客户端解压失败。
为什么 zip.Writer 写入 HTTP 响应后文件打不开
根本原因是 ZIP 格式末尾必须有 EOCD（End of Central Directory）记录，而 zip.Writer.Close() 才会刷新缓冲、写入该结构。漏掉这一步，生成的字节流是不合法 ZIP，7-Zip 或 macOS 归档工具会报“无法打开存档”或静默失败。
- 常见错误现象：
io.Copy返回 nil，http.ResponseWriter看似写成功，但浏览器下载的 ZIP 双击无反应、解压提示“损坏” - 必须在所有文件写入完成后、函数返回前调用
zipWriter.Close()；defer zipWriter.Close()是安全写法，但注意它只在函数退出时触发，若中间 panic 未 recover，仍可能遗漏 - 不要用
zipWriter.Flush()替代 —— 它只刷缓冲，不写 EOCD
如何安全设置 ZIP 内部路径避免越界解压
ZIP 中的文件路径会原样用于解压时的文件系统写入，传入绝对路径（如 /etc/passwd）或含 ../ 的路径，可能覆盖服务端关键文件。必须做白名单校验与路径净化。
- 对每个待打包的原始路径，先用
filepath.Clean()规范化，再用strings.HasPrefix(cleaned, allowRoot)判断是否在允许目录内（如"./files/"） -
w.Create()或w.CreateHeader()中传入的Name字段必须是相对路径，且不含盘符、前导/或../；Windows 下filepath.Rel()返回反斜杠，需用strings.ReplaceAll(rel, "\", "/")统一为正斜杠 - 禁止直接信任用户输入的文件名；若从 URL 参数或表单获取路径，必须严格过滤：拒绝空字符、控制字符、设备名（如
NUL,CON）和扩展名黑名单（如.sh,.exe）
如何控制压缩行为：Store 还是 Deflate？
默认情况下 zip.Writer 对所有文件使用 zip.Deflate，但并非所有场景都需要压缩。小文件或已压缩格式（如 .jpg, .png）开启 Deflate 反而增加 CPU 开销且几乎不减体积。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 用
zip.FileInfoHeader()创建头后，显式设置header.Method = zip.Store可跳过压缩，仅归档（等效于zip -0） - 对文本类大文件（日志、CSV），保留
zip.Deflate；对二进制资源，建议先mime.TypeByExtension(ext)判断类型，对image/*,video/*,application/gzip等设为zip.Store - 不支持自定义压缩级别（如 zlib level 1–9），Go
archive/zip固定使用默认 Deflate 参数；如需精细控制，得换用github.com/klauspost/compress等第三方库
并发打包多个 ZIP 流时要注意句柄泄漏
一个 HTTP handler 启动多个 goroutine 并发处理不同用户的 ZIP 下载请求时，若每个都用 os.Open() 打开文件但未及时关闭，容易触发 “too many open files” 错误。
- 每个
os.Open()后必须配对file.Close()，不能只依赖defer—— defer 在函数返回时才执行，而 handler 函数可能早于所有 goroutine 结束就返回了 - 更稳妥的做法：在 goroutine 内部完成
os.Open → w.Create → io.Copy → file.Close()全流程，确保资源在本协程内释放 - 如果需复用文件句柄（如高频访问同一组模板文件），可提前
os.Open并缓存 *os.File，但要加读锁（sync.RWMutex），且注意file.Stat()和file.Read()都是线程安全的
最容易被忽略的是路径校验与 w.Close() 的组合：前者防安全漏洞，后者保 ZIP 合法性，二者缺一不可。哪怕只打包一个文件，这两个点出错，整个功能就失效。
