Go archive/tar 读取 PAXRecords 后字段为什么会丢失

直接答案：archive/tar.Reader 通常没有把 PAX 字段删掉。标准 PAX 键会被合并到 Header.Name、Size、ModTime 等字段，同时 PAXRecords 保存扩展记录。真正的“丢失”多发生在后续重建 Header 时没有复制 map，或者写回时误以为同名 PAXRecords 能覆盖标准字段。

先判断字段是真丢了，还是换了位置

PAX 使用扩展头突破 USTAR 对路径、大小和时间精度的限制。Go 读取普通文件条目前，会解析前置的 PAX 头，并把 path、size、mtime 等已知键合并到 Header。因此只打印 map 或只打印结构体，都可能造成误判。

for {
    hdr, err := tr.Next()
    if err == io.EOF {
        break // 归档读取结束
    }
    if err != nil {
        return err
    }

    // 同时观察标准字段和原始扩展记录
    fmt.Printf("name=%q size=%d mtime=%s\n", hdr.Name, hdr.Size, hdr.ModTime)
    for key, value := range hdr.PAXRecords {
        fmt.Printf("pax[%q]=%q\n", key, value)
    }
}

最常见的丢失点在 Header 重建

很多程序读取后会调用 tar.FileInfoHeader，或用结构体字面量创建新头。这样的新对象只包含显式赋值的字段，不会自动继承旧 Header.PAXRecords。如果随后把新头写入归档，自定义键自然不见了。

func clonePAX(src map[string]string) map[string]string {
    if len(src) == 0 {
        return nil
    }
    dst := make(map[string]string, len(src))
    for key, value := range src {
        dst[key] = value // 创建调用方拥有的独立副本
    }
    return dst
}

out := &tar.Header{
    Name:       hdr.Name,
    Mode:       hdr.Mode,
    Size:       hdr.Size,
    ModTime:    hdr.ModTime,
    Typeflag:   hdr.Typeflag,
    PAXRecords: clonePAX(hdr.PAXRecords),
}

独立复制还有一个好处：后续删除、补充自定义键时，不会意外修改仍在使用的原 map。若只想保存业务扩展，也可以按命名空间筛选，例如只保留 ACME. 前缀。

写回时要理解字段优先级

Writer.WriteHeader 会根据 Header 的其他字段生成必要的 PAX 记录，而且这些派生值优先于 PAXRecords 中的同名值。例如同时设置 hdr.Name 与 PAXRecords["path"]，最终路径应以 Name 为准。自定义键则应使用大写厂商命名空间，如 ACME.build.id，避免和标准键冲突。

用重新读取完成复查

不要把 WriteHeader 返回成功当作字段已经按预期保存。关闭 Writer 后重新创建 Reader，逐条对比 Name、Size、时间字段和业务自定义键。若标准键不同，回到 Header 字段检查；若只有自定义键缺失，回查复制和过滤逻辑。

// 写入前显式设置业务扩展字段
if out.PAXRecords == nil {
    out.PAXRecords = make(map[string]string)
}
out.PAXRecords["ACME.build.id"] = "20260926.1"

if err := tw.WriteHeader(out); err != nil {
    return err
}

常见问题

PAXRecords 里的 path 能覆盖 Header.Name 吗？

写入时不要这样设计。官方文档明确说明，由 Header 其他字段派生的 PAX 记录优先于 PAXRecords；路径应直接修改 Name。

能直接复用 Reader.Next 返回的 Header 吗？

只读检查可以；要修改并重新写入时，更稳妥的做法是新建 Header，只复制需要保留的字段，并为 map 创建独立副本，这也符合标准库对前向兼容的建议。