Golang archive/tar直接写Buffer致归档损坏，改用io.Copy正常的原因

核心原因是单次tar.Writer.Write调用可能无法写入全部数据（短写），而你的代码没有处理这种情况，导致实际写入的字节数少于Header中声明的Size，破坏了tar文件的块结构。

具体细节： #

1. tar文件的结构要求：tar格式按512字节的块组织，每个文件的内容必须严格匹配Header里声明的Size，且会自动填充到512字节的整数倍。如果写入字节数不足Size，tar工具会判定文件数据不完整，抛出类似A lone zero block的结构错误。

2. tar.Writer.Write的行为：
   它遵循Go的io.Writer规范——允许在无错误的情况下，返回写入字节数小于输入的字节数（比如底层文件系统的系统调用限制、缓冲区大小限制等）。当你直接调用writer.Write(uo.buffer)时，如果出现这种短写，你的代码没有继续写入剩余数据，导致实际写入字节数少于Header.Size，tar文件结构被破坏。

3. io.Copy的作用：
   io.Copy内部会循环调用Write，直到从Reader读取的所有数据都被写入Writer。即使第一次Write只写入部分数据，它会继续处理剩余字节，确保最终写入总字节数等于uo.buffer的长度（也就是Header.Size），满足tar格式要求。

替代修复方案： #

如果不想用io.Copy，也可以手动循环写入剩余数据，确保全部字节被写入：

buf := uo.buffer
for len(buf) > 0 {
    n, err := writer.Write(buf)
    if err != nil {
        return err
    }
    buf = buf[n:]
}

这段代码效果和io.Copy一致，能避免短写带来的问题。

内容的提问来源于stack exchange，提问作者ch66