Go标准库无tar.gz一键函数，必须手动组合archive/tar与compress/gzip：压缩需os.File→gzip.NewWriter→tar.NewWriter嵌套，解压需gzip.NewReader→tar.NewReader；Header.Typeflag、Size、Name须显式设置且路径清洗，关闭顺序为tw.Close()→gw.Close()→f.Close()。
Go 标准库不提供 tar.gz 一键压缩/解压函数，必须手动组合 archive/tar 和 compress/gzip，且嵌套顺序、关闭时机、Header 字段设置三者任一出错，生成的文件就可能被 gunzip -t 报 unexpected end of file 或被 tar.NewReader 拒绝解析。
压缩目录为 tar.gz：必须先 tar 再 gzip，且顺序不能反
错误做法是先写 tar.Writer 到 *os.File，再用 gzip 单独压缩该文件——这会产生双层头信息，解压时会错位。正确路径是：创建 *os.File → 包一层 gzip.NewWriter → 再包一层 tar.NewWriter。
-
tar.Writer必须由gzip.Writer构造，不能绕过它直接写文件 - 遍历目录推荐用
filepath.WalkDir（比filepath.Walk更安全，避免符号链接循环） - 每个文件写入前，
tar.Header.Name必须是相对路径（不能以/开头），Windows 路径需转为 Unix 风格：filepath.ToSlash(strings.TrimPrefix(path, root)) -
Header.Typeflag不可省略：普通文件设为tar.TypeReg，目录设为tar.TypeDir（且Name末尾带/） -
Header.Size必须是int64，且和后续实际写入字节数严格一致；大文件别用io.ReadAll，改用io.Copy(tw, file)
解压 tar.gz：必须先 gzip.NewReader，再 tar.NewReader
典型报错 archive/tar: invalid tar header 几乎都源于直接把 .tar.gz 文件传给 tar.NewReader，没经过 gzip.NewReader 解包。gzip 流必须先解压成原始 tar 流，tar.NewReader 才能识别 header。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 打开文件后，立即用
gzip.NewReader(f)包装，再把返回的io.Reader传给tar.NewReader -
tr.Next()每次返回一个*tar.Header，其Size是精确字节数，必须用io.CopyN(dest, tr, hdr.Size)读取，不能用io.Copy(dest, tr)读到io.EOF——否则会吞掉下一个 header - 对
hdr.Typeflag == tar.TypeDir的条目，只调os.MkdirAll(filepath.Dir(hdr.Name), 0755)，跳过内容写入（Size为 0） - 路径校验不可少：
cleanName := filepath.Clean(hdr.Name)，若cleanName != hdr.Name || strings.HasPrefix(cleanName, "..")，直接跳过，防 Zip Slip
关闭顺序和资源释放：tw.Close() → gw.Close() → f.Close()
漏掉任意一个 Close() 都会导致 gzip 流不完整，gunzip -t 报错。尤其注意：tw.Close() 必须在 gw.Close() 之前调用，否则 gzip.Writer 缓冲区里的 CRC 和 ISIZE 尾部数据写不进去。
-
tw.Close()：结束 tar 流，写入 padding block -
gw.Close()：结束 gzip 流，写入 CRC + ISIZE -
f.Close()：关闭底层文件句柄 - 别依赖
defer自动处理——如果中间 panic 或提前 return，tw和gw可能根本没 Close，生成损坏文件
跨平台和旧工具兼容：Format 和 Mode 设置易被忽略
Go 默认用 tar.FormatPAX（POSIX.1-2001），但 BusyBox、某些嵌入式设备上的 tar 只认 tar.FormatGNU。另外，Header.Mode 是 Unix 权限位（如 0644），不是 os.FileMode 字符串，设错会导致解压后文件不可读。
- 如需兼容旧工具，在创建
tar.Writer后立刻设：tw.Format = tar.FormatGNU -
Header.Mode必须显式赋值，例如hdr.Mode = int64(fileInfo.Mode().Perm()) | 0o100000（普通文件）或| 0o040000（目录） - 时间戳建议设
hdr.ModTime = fileInfo.ModTime()，否则部分工具解压后显示时间为 1970 - 硬链接、设备文件等特殊类型默认被跳过，生产环境若需支持，得手动检查
fileInfo.Sys()并设置对应Typeflag
最常被跳过的其实是 Typeflag 显式赋值和关闭顺序——这两个点不出问题，tar.gz 才算真正“能被 Go 原生解析”。其他语言或工具可能宽容，但 Go 的 tar 包校验严格，不妥协。
