Go archive/zip 写入文件时怎么设置条目的修改时间

给 ZIP 文件里的条目设置修改时间，关键不是改写磁盘上源文件的时间，而是使用 archive/zip.FileHeader 携带元数据，再调用 Writer.CreateHeader 写入。新代码可以直接设置 FileHeader.Modified；如果用的是较旧的 Go 写法，也会看到 SetModTime，但它已经标记为 deprecated。

先把修改时间写进 FileHeader

下面的例子把一个稳定的时间写入 docs/readme.txt。注意，CreateHeader 返回的写入器只负责条目内容，修改时间属于 header 元数据。

package main

import (
    "archive/zip"
    "bytes"
    "fmt"
    "io"
    "time"
)

func makeArchive() ([]byte, error) {
    var buffer bytes.Buffer
    zw := zip.NewWriter(&buffer)

    // 用固定的 UTC 时间，避免每次打包结果依赖运行机器的本地时区。
    modified := time.Date(2026, time.January, 5, 9, 30, 0, 0, time.UTC)
    header := &zip.FileHeader{
        Name:     "docs/readme.txt",
        Method:   zip.Deflate,
        Modified: modified,
    }

    entry, err := zw.CreateHeader(header)
    if err != nil {
        return nil, fmt.Errorf("创建 ZIP 条目失败: %w", err)
    }
    // 条目内容写完后，才能继续创建下一个条目或关闭 Writer。
    if _, err = io.WriteString(entry, "归档文件说明\n"); err != nil {
        return nil, fmt.Errorf("写入条目内容失败: %w", err)
    }
    if err = zw.Close(); err != nil {
        return nil, fmt.Errorf("关闭 ZIP 写入器失败: %w", err)
    }
    return buffer.Bytes(), nil
}

func main() {
    data, err := makeArchive()
    if err != nil {
        panic(err)
    }
    fmt.Println("ZIP 字节数:", len(data))
}

这里没有使用 zip.Writer.Create，因为 Create 只接收名称，适合默认元数据的简单场景。需要时间、权限或压缩方法时，先构造 FileHeader 再调用 CreateHeader。

为什么跨机器打包时要先统一时区

time.Time 带有地点信息。如果一台机器用北京时间、另一台机器用本地时间直接填入 header，同一个业务时刻可能显示成不同的墙上时间。归档服务通常把输入时间转换为 UTC 后再写入，并在展示层按用户时区格式化。

固定构建产物时，也不要把 time.Now() 直接写进条目，否则同样的源码每次生成的 ZIP 元数据都不同。若时间来自文件系统，可以先读取 fs.FileInfo.ModTime()；若时间来自业务字段，则明确约定它是 UTC 还是某个地区的本地时间，再统一转换。

读回时间为什么可能少一两秒

ZIP 兼容字段使用传统 MS-DOS 日期和时间表示，时间精度通常是 2 秒。Go 文档中的 FileHeader.ModTime 与 SetModTime 也说明了这一边界；新版本推荐使用 Modified 字段。因而输入带有奇数秒或纳秒时，读回值可能被截断或量化，不能用纳秒级相等判断归档是否成功。

四个容易踩坑的检查点

1. 先设置再 CreateHeader。 Writer 接管 header 后可能修改它，调用后不要再依赖或修改同一个指针。
2. 不要只改源文件时间。 源文件的 os.Chtimes 不会自动改变已经创建的 ZIP 条目。
3. 不要漏掉 Close。 ZIP 的目录信息在关闭写入器时完成，内容写完后要检查 zw.Close() 的错误。
4. 比较时留出精度边界。 测试可将时间截断到 2 秒，或比较一个小范围，而不是硬编码纳秒相等。

常见问题

只调用 zip.Writer.Create，能设置修改时间吗？

不能直接传入时间。需要自定义条目元数据时，改用 FileHeader 和 CreateHeader。

SetModTime 还能不能用？

兼容旧代码仍可使用，但当前 Go 文档把它标记为 deprecated，新代码直接设置 FileHeader.Modified 更清楚。

为什么设置了 09:30，读出来不是完全一样？

先检查时区，再考虑 ZIP 传统时间字段的 2 秒精度；如果只是少 1 秒，通常属于编码粒度差异。

把时间写入 ZIP 的正确边界是：业务时间先统一，条目元数据放进 FileHeader，内容通过 CreateHeader 写入，最后检查 Close。这样既能控制修改时间，也不会把源文件属性和归档元数据混为一谈。