Go用archive/zip压缩需手动写入文件头与内容：调用CreateHeader/Create创建条目，再写入数据；路径用/分隔；打包目录要过滤符号链接和隐藏文件；中文名需设header.Flags=1启用UTF-8。
用 archive/zip 压缩单个文件时，必须手动写入文件头和内容
Go 标准库不提供“一键压缩”函数，zip.Writer 只负责构建 ZIP 结构，你需要自己调用 writer.CreateHeader() 或 writer.Create() 创建条目，再把源文件内容写进去。漏掉任一环节都会导致 ZIP 文件损坏或解压为空。
-
writer.Create("foo.txt")返回一个io.Writer，后续写入的数据会作为该文件内容；适合小文件或内存中生成的内容 - 压缩已有文件时，更稳妥的方式是：
header := &zip.FileHeader{Name: "bar.txt", Method: zip.Deflate}→header.SetModTime(time.Now())→w, _ := writer.CreateHeader(header)→io.Copy(w, srcFile) - 注意：ZIP 中路径分隔符必须用
/（即使在 Windows 上），否则部分解压工具无法识别目录结构
打包整个目录时，递归遍历需跳过符号链接和系统隐藏文件
直接 filepath.Walk 会进入符号链接目标、.git 目录、临时文件等，不仅增大 ZIP 体积，还可能触发权限错误或循环引用。必须显式过滤。
- 检查
os.FileInfo.Mode() & os.ModeSymlink != 0跳过符号链接 - 对每个路径用
strings.HasPrefix(fi.Name(), ".")过滤隐藏文件（如.DS_Store、.gitignore） - 路径重写要保留相对结构：若从
/tmp/project开始打包，/tmp/project/src/main.go应写入 ZIP 的src/main.go，而非绝对路径 - 用
strings.TrimPrefix(absPath, baseDir)+strings.ReplaceAll(..., "\", "/")统一路径分隔符
archive/tar 不带压缩，但配合 gzip 或 zstd 可实现 .tar.gz / .tar.zst
archive/tar 本身只做归档，不是压缩格式。常见 “tar.gz” 实际是先 tar 再 gzip 流式编码，不能直接用 tar.Writer 写入 *gzip.Writer 就完事——顺序和关闭时机很关键。
- 正确链路：
file, _ := os.Create("out.tar.gz")→gzipWriter := gzip.NewWriter(file)→tarWriter := tar.NewWriter(gzipWriter) - 写完所有文件后，必须按相反顺序关闭：
tarWriter.Close()→gzipWriter.Close()→file.Close()，否则 gzip 尾部校验数据丢失，解压报invalid checksum - 如果要用 zstd（比 gzip 压缩率更高），替换
gzip.NewWriter为zstd.NewWriter（需引入github.com/klauspost/compress/zstd） -
tar.Header.Size必须设为真实文件字节数，否则解压时截断或卡住
中文文件名在 ZIP 中乱码，是因为 Go 默认用 UTF-8 编码而多数解压工具认 CP437
ZIP 规范本身不强制字符编码，archive/zip 把 FileHeader.Name 当作原始字节写入。Windows 资源管理器、macOS 归档工具默认按 CP437 解析，导致中文显示为 或乱码。
立即学习“go语言免费学习笔记（深入）”；
- 最兼容方案：启用 ZIP 的 UTF-8 标志位 —— 设置
header.Flags = 1 （即 <code>zip.UseUTF8），且确保Name是合法 UTF-8 字符串 - 注意：老版本 Windows（如 Win7）原生解压程序不支持该标志，会忽略文件名直接解压；此时只能改用拼音/英文名，或依赖 7-Zip / The Unarchiver 等现代工具
- 不要尝试用
gobindata或 base64 编码文件名，这会让 ZIP 失去通用性
func createZipWithUTF8(filename string, files map[string][]byte) error {
f, _ := os.Create(filename)
defer f.Close()
w := zip.NewWriter(f)
defer w.Close()
for name, content := range files {
header := &zip.FileHeader{
Name: name,
Method: zip.Deflate,
Flags: 1 << 11, // 启用 UTF-8
}
header.SetModTime(time.Now())
fw, _ := w.CreateHeader(header)
fw.Write(content)
}
return w.Close()
}
路径处理、编码标志、流关闭顺序这三处，稍有疏忽就会产出看似正常实则无法通用的归档文件。 
