go的archive/zip不支持直接压缩目录，必须用filepath.walkdir（go 1.16+）手动遍历，先os.stat校验路径合法性并转绝对路径，再归一化相对路径为正斜杠、显式写入带/结尾的目录项（method=store），文件项设method=deflate，最后务必调用w.close()。
Go 的 archive/zip 不支持直接压缩目录，必须手动遍历并构造每个 zip.FileHeader；漏掉 w.Close() 或路径未归一化会导致 ZIP 打不开或解压结构错乱。
如何用 filepath.WalkDir 正确遍历目录并写入 zip.Writer
遍历不是简单调用 filepath.Walk 就完事——它会跟随符号链接、对权限错误静默失败，而 filepath.WalkDir（Go 1.16+）能区分 symlink 和真实目录，且错误可捕获。
- 先用
os.Stat校验源路径是否为可读目录，避免传入软链接或空路径 - 统一转为绝对路径：
absRoot, _ := filepath.Abs(root)，防止相对路径导致 ZIP 内出现../ - 回调中对每个条目调用
fi.IsDir()：是目录则需显式创建条目，末尾加/，且header.Mode().IsDir()必须为true - 文件路径用
filepath.Rel(absRoot, path)获取相对路径，再经filepath.ToSlash(filepath.Clean(rel))归一化——Windows 下的\和多余.、..全部清除 - 不要用
filepath.Base()提取文件名，它丢弃所有父级，ZIP 里只剩一堆同名文件，无任何目录结构
为什么 zip.Writer.CreateHeader 后必须设 header.Method = zip.Deflate
默认所有写入都走 zip.Store，即仅打包、不压缩。你看到的 .zip 文件体积和原始文件总和几乎一致，解压也快，但这不是“压缩”，只是归档。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
w.CreateHeader(&header)不自动启用压缩，必须手动赋值：header.Method = zip.Deflate - 空目录只能用
zip.Store（Deflate 对空内容无意义），所以目录项要单独判断：if fi.IsDir() { header.Method = zip.Store } - 即使设了
Deflate，极小文件（如 Store，这是正常行为，不是 bug - 没设
Method就写入内容，ZIP 能打开、能看到文件列表，但双击打开文件时提示“损坏”或“无法读取”
解压时如何防 Zip Slip 并安全还原目录结构
ZIP 文件里的 f.Name 完全由打包方控制，../../../etc/passwd 这类路径在 Windows 资源管理器或 unzip -t 中均不拦截，直接拼接写入等于开放任意路径写入。
- 对每个
f.Name先调cleaned := filepath.Clean(f.Name)，再检查strings.HasPrefix(cleaned, "..") || strings.HasPrefix(cleaned, ".") - 更稳妥的是计算目标绝对路径：
absDst := filepath.Join(dstDir, cleaned)，然后用strings.HasPrefix(filepath.ToSlash(absDst), filepath.ToSlash(expectedBase))校验是否仍在允许根目录内 - 遇到
f.IsDir() == true的条目，必须调os.MkdirAll(filepath.Dir(dstPath), 0755)—— ZIP 不保证父目录先出现，不能依赖顺序 - 中文文件名需打包端设
header.Flags |= 0x800，解压端 Go 1.22+ 才默认 UTF-8 解码；旧版本需手动注册解压器
大目录压缩时容易被忽略的资源与性能细节
递归压缩几百个文件看似简单，但句柄泄漏、缓冲区不足、磁盘满、时间戳丢失都会让备份半途失败，且错误难定位。
-
w.Close()必须显式调用并检查返回 error：它写入中央目录，漏掉则 ZIP 文件“有头无身”，多数 GUI 工具显示为空 - 避免在循环里
defer f.Close()—— 多个 defer 累积延迟释放，可能触发“too many open files”；应f.Close()后立即继续 - 对大文件（>10MB），用
bufio.NewWriterSize(w, 1 包裹 <code>zip.Writer，减少系统调用次数 - 每个文件写入前设
header.ModTime = fi.ModTime()，否则所有文件时间戳变成打包时刻，影响后续增量比对 - 硬链接会被
WalkDir当作两个独立文件重复写入，体积翻倍；若需去重，得自己维护 inode 缓存
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
