go标准库archive/tar不支持追加写入，必须全量重建或采用分片+索引方案；tar.writer为一次性写入器，close后不可复用；os.o_append会破坏tar格式结构；生产中推荐固定大小tar分片配合外部索引实现高效随机访问。
如何用 archive/tar 手动构造 TAR 文件
Go 标准库不提供一键打包多个文件的高层 API，必须自己管理 tar.Header 和写入顺序。核心是：先写 header，再写 body；每个文件需独立调用 tw.WriteHeader() 和 tw.Write()。
-
tar.Header中Name必须是相对路径（不能以/开头），且推荐统一用/分隔（Windows 下也别用\） -
Size字段必须准确填写，否则解包会失败或截断 —— 不能设为 0 或估算值，得提前stat.Size() - 目录项也要写入：
Typeflag设为tar.TypeDir，Size设为 0，Name末尾加/ - 注意文件读取和写入的错误要分别检查，
tw.Write()失败不会自动回滚前面已写的 header
为什么 os.Open() 后必须用 io.Copy() 而不是 ReadAll()
大文件（比如几百 MB 的日志）用 ReadAll() 会一次性加载进内存，极易 OOM；而 io.Copy() 是流式转发，内存占用恒定在几 KB。
- 直接
io.Copy(tw, f)即可，无需中间 buffer - 若需预处理内容（如压缩、加密），才考虑分块读取 +
tw.Write()，但务必保证总字节数与 header 中Size一致 - 特别注意：
io.Copy()返回实际写入字节数，应与header.Size对比校验，不匹配说明源文件被截断或并发修改
遇到 archive/tar: write too long 错误怎么排查
这是最典型的 TAR 写入错误，根本原因是写入内容长度超过了 tar.Header.Size 声明的值。
- 常见诱因：文件在
os.Stat()后、io.Copy()前被修改（尤其是日志轮转场景） - 另一个坑：符号链接未按需处理 —— 若
os.Stat()返回的是 symlink，但你直接os.Open()它，可能打开的是目标文件，大小已变 - 解决方法：对 symlink 显式判断，用
os.Lstat()获取原始信息；必要时加filepath.EvalSymlinks()再比对 size - 调试技巧：在
io.Copy()后打印n, err，确认是否等于header.Size
归档时保留权限和修改时间要注意什么
tar.Header 默认只填 Name 和 Size，其他字段留零会导致解包后权限变成 600、mtime 变成 epoch 零点。
-
Mode应设为stat.Mode().Perm()（注意不是stat.Sys().(*syscall.Stat_t).Mode，后者含额外 flag） -
ModTime直接赋stat.ModTime()即可，tar包内部用 UTC 时间戳，Go 会自动转换 - 用户/组 ID 在跨平台解包时意义有限，一般设
Uid/Gid = 0即可；若需保留，从stat.Sys().(*syscall.Stat_t)提取（Linux/macOS） - Windows 上
Mode不影响权限（ACL 由 unpacker 解释），但设了也没坏处
真正难的是递归遍历 —— filepath.Walk 不保证顺序，而 TAR 规范建议目录在前、文件在后；若要严格兼容老工具，得先收集路径再排序，再按深度优先写入。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
