tar.Writer写入时文件内容为空？
Go 的 tar.Writer 不会自动读取文件内容，它只按你给的 io.Reader 写入字节流。常见错误是直接传入空的 bytes.NewReader(nil) 或忘了调用 file.Read()。
- 必须显式打开源文件（
os.Open），并确保tar.Header.Size与实际读取字节数一致 - 若用
strings.NewReader或bytes.NewReader模拟内容，需确认长度赋值正确：header.Size = int64(len(content))
- 忘记在写完每个文件后调用
tw.Write()（不是tw.WriteHeader()）会导致该文件体丢失 - Windows 下路径分隔符为
，但 tar 规范要求/，需提前替换：strings.ReplaceAll(filepath.ToSlash(name), "\", "/")
如何正确处理子目录和相对路径？
tar 归档中路径是纯字符串，没有“目录对象”，只有文件条目。归档内出现 dir/ 这种结尾带斜杠的条目，其实是人为写入的 typeflag = tar.TypeDir，标准库不自动生成。
- 遍历目录时，对每个
os.FileInfo判断IsDir()，若为真则手动构造一个tar.Header，设置Typeflag: tar.TypeDir和Mode: 0755 - 文件路径应使用相对于归档根的相对路径（如
src/main.go），避免绝对路径（/home/user/src/main.go）——否则解压可能失败或越权 -
filepath.Walk返回路径是主机本地格式，必须转为 POSIX 风格再写入Header.Name
解压时出现 “archive/tar: invalid tar header”？
这个错误几乎都源于 header 数据不合法：长度超限、name 字段含控制字符、size 为负数、或 magic 字段被破坏。
-
tar.Header.Name最长 100 字节（POSIX 标准），超长会被截断并导致后续解析错位；建议用tar.FormatPAX（支持长名）并设置tw.Format = tar.FormatPAX -
Size必须是非负整数，且不能大于实际可读字节数；常见坑是用stat.Size()读符号链接目标大小，但没os.Stat到目标，而是os.Lstat到链接本身（返回 0） - 解压端若用
tr.Next()后未检查err == nil就直接读取，遇到损坏 header 会 panic；务必先判错：for err := tr.Next(); err == nil; err = tr.Next() { ... }
内存敏感场景下如何避免一次性加载大文件？
tar.Writer 本身是流式写入，但很多人误以为必须把整个文件读进 []byte 才能写。其实只要提供稳定长度的 io.Reader，就能边读边压。
立即学习“go语言免费学习笔记（深入）”；
- 对大文件，直接用
os.Open得到的*os.File作为io.Reader传给tw.Write()，无需中间缓冲 - 注意：
os.File支持io.Seeker，但tar.Writer不需要 seek，所以管道、网络响应体等非 seekable reader 也能用（只要 size 已知） - 如果文件列表极大（如百万级小文件），别用
filepath.Walk递归全量扫描再建 slice——改用filepath.WalkDir+ channel 控制并发读取，减少内存驻留
tar 的行为高度依赖 header 字段的准确性，而不是 Go 类型系统能约束的部分。写 header 时多看一眼 Name、Size、Typeflag，比事后调试解压失败省十倍时间。
