Go archive/tar Header.AccessTime 怎样保留文件访问时间

我第一次需要把文件元数据放进 tar 时，最容易漏掉的不是 ModTime，而是 Header.AccessTime：字段明明赋了值，重新读出来却像没有保存。原因在于 Go 的 archive/tar 不会在未指定格式时自动保证访问时间，写入前必须把格式能力和时间精度一起想清楚。

结论是：需要保留访问时间时，给 Header.Format 显式设置为 tar.FormatPAX 或 tar.FormatGNU，再调用 Writer.WriteHeader。PAX 还支持子秒时间；如果格式未指定，Writer 会忽略 AccessTime 和 ChangeTime。

官方文档：https://pkg.go.dev/archive/tar#Header

Header.AccessTime 与 ModTime 不是一回事

ModTime 是文件内容最后修改时间，AccessTime 是访问时间。它们都使用 time.Time，但 tar 格式对它们的支持不同：USTAR 没有访问时间字段；PAX 和 GNU 可以保存访问时间，其中 PAX 支持子秒精度，GNU 主要保存整数秒。

所以，单纯写下面这一行并不能保证结果：

// 只给字段赋值还不够，格式能力决定它能否进入归档。
hdr.AccessTime = accessTime

真正决定写入结果的是 WriteHeader 看到的完整 Header。未指定 Format 时，Writer 会选择能够编码当前 Header 的格式，但官方文档明确说明这种情况下会忽略 AccessTime 和 ChangeTime。生产代码不要把“字段有值”当成“归档一定有值”。

写入访问时间时，先固定格式再写 Header

下面示例把一条普通文件写入内存中的 tar，并保留访问时间。选择 PAX 是因为它同时支持较长字段和子秒时间；示例中的时间来自业务对象，实际项目可替换成文件系统元数据或数据库记录。

package main

import (
    "archive/tar"
    "bytes"
    "fmt"
    "time"
)

// buildArchive 只负责生成tar字节，不修改本地文件时间。
func buildArchive(body []byte, accessTime time.Time) ([]byte, error) {
    var buf bytes.Buffer
    tw := tar.NewWriter(&buf)
    hdr := &tar.Header{
        Name:       "report.txt",
        Mode:       0600,
        Size:       int64(len(body)),
        ModTime:    time.Date(2026, 10, 18, 9, 0, 0, 0, time.UTC),
        AccessTime: accessTime,
        // PAX才能可靠表达AccessTime，并保留子秒精度。
        Format: tar.FormatPAX,
    }
    if err := tw.WriteHeader(hdr); err != nil {
        return nil, fmt.Errorf("写入tar头: %w", err)
    }
    if _, err := tw.Write(body); err != nil {
        return nil, fmt.Errorf("写入tar内容: %w", err)
    }
    // Close负责补齐块并写入归档尾部，不能省略。
    if err := tw.Close(); err != nil {
        return nil, fmt.Errorf("关闭tar: %w", err)
    }
    return buf.Bytes(), nil
}

这里有三个容易被忽略的点。第一，Size 必须和要写入的字节数一致；第二，WriteHeader 成功后再写正文，不能把 Header 当成普通字节直接拼接；第三，Close 会补齐当前成员的块并写入归档尾部，省略它会得到不完整的 tar。

如果目标工具只支持 GNU 格式，可以把 FormatPAX 换成 FormatGNU，但要接受它没有 PAX 那样的子秒时间能力。不要为了“字段看起来完整”把 PAXRecords 中的自定义键当成 AccessTime 的替代品；标准字段应由格式本身承载。

读取时怎样判断 AccessTime 是否真的存在

读取端用 tar.Reader.Next 得到 Header 后，先判断 AccessTime.IsZero()，再决定是否把它当作业务时间。零值表示没有可用的访问时间，不能直接格式化成当前时间，也不能把 Unix 起点误认为原文件访问时间。

// readAccessTime只读取Header元数据，不解包到磁盘。
func readAccessTime(r io.Reader) error {
    tr := tar.NewReader(r)
    for {
        hdr, err := tr.Next()
        if err == io.EOF {
            return nil // 归档结束，属于正常结果。
        }
        if err != nil {
            return fmt.Errorf("读取tar头: %w", err)
        }
        if hdr.AccessTime.IsZero() {
            // 没有访问时间时保留“未知”，不要伪造时间。
            fmt.Printf("%s: AccessTime=未提供\n", hdr.Name)
            continue
        }
        // RFC3339Nano保留可用的小数秒，便于观察PAX精度。
        fmt.Printf("%s: AccessTime=%s\n", hdr.Name, hdr.AccessTime.Format(time.RFC3339Nano))
    }
}

这段代码需要在完整程序中补齐 io 和 fmt 的 import。它只展示读取接口，未在本轮执行；如果业务还要读取成员正文，应在成功取得 Header 后处理当前 Reader，并单独处理正文读取错误。

未指定格式、PAX 和 GNU 怎么选

我的取舍是：下游没有明确限制时优先 PAX；下游明确只认 GNU 时再使用 GNU；需要最老的 USTAR 兼容时，主动把 AccessTime 当作不可保留字段，并在文档里写清楚。这样比写入后才发现时间丢失更容易排查。

还要注意，读取器得到的 Header.Format 是对归档格式的尽力判断，某些非规范文件可能返回 FormatUnknown。因此读取端更应该以 AccessTime.IsZero 判断字段是否可用，而不是只根据 Format 名称推断具体时间一定存在。

发布或归档前，做一张元数据检查清单

生产代码可以把检查集中在写入边界：确认访问时间不是业务上的零值；确认格式是 PAX 或 GNU；确认 Size 和正文长度一致；确认 WriteHeader、Write、Close 的错误都被处理。读取端则保留“未知”和“已提供”两种状态，不要用默认时间填补缺失。

如果归档还要跨语言或跨工具流转，最好用一份包含普通文件、零值时间和带子秒时间的样本，由下游工具各自读取后对照。这个对照属于你的系统集成测试，不能只看 Go 侧 Header 赋值成功。

为什么 AccessTime 有值，读出来却是零值？

最常见原因是写入时没有显式使用 PAX 或 GNU，Writer 按文档忽略了该字段；也可能是下游工具重新打包时丢弃了访问时间。

PAX 和 GNU 都能保存访问时间，应该优先哪个？

没有兼容性硬约束时优先 PAX，因为它支持子秒精度；如果接收方明确要求 GNU，则选择 GNU，并把秒级精度写进接口约定。

AccessTime.IsZero 能证明原文件从未访问过吗？

不能。它只能说明当前 Header 没有可用访问时间；归档格式不支持、写入端未提供或中间工具丢弃字段，都可能导致零值。

把 AccessTime 当成“需要格式配合的元数据”，这篇问题就不会再停留在字段赋值层面：写入端固定格式，读取端检查零值，集成端确认下游能力，三处边界都明确后，tar 中的访问时间才真正可控。