Go gzip.Writer 怎么设置文件名和修改时间

不少用Go做gzip压缩开发的朋友都碰到过这个问题：直接用标准库默认的gzip.Writer生成的压缩包，解压后不会带出你预设的文件名，解压出来的文件修改时间也默认是系统旧时间，不符合业务需求。这两个需求不需要引入任何第三方依赖，直接操作标准库暴露的结构体字段就能实现。

初始化完gzip.Writer实例之后，修改它内置的Header结构体的Name字段即可设置压缩后归档的文件名，修改Header结构体的ModTime字段传入Unix时间格式的时间值，就能自定义解压后文件显示的修改时间。

Go 的 compress/gzip 可以把原始文件名和修改时间写进 GZIP 头。关键做法是：创建 gzip.Writer 后，先设置 zw.Name 与 zw.ModTime，再调用第一次 Write、Flush 或 Close。如果先写数据，头字段已经开始输出，后面再改值就不能可靠地影响当前流。

官方地址：https://pkg.go.dev/compress/gzip

下面的例子把元数据写入内存，再用 Reader 读回，适合验证归档、缓存键或测试样例中的稳定性。

Go gzip.Writer 的 Name 和 ModTime 应该在什么时候设置

gzip.Writer 暴露了 GZIP 头中的字段。Name 表示原始文件名，ModTime 表示修改时间；它们属于压缩流头部，不是压缩正文。设置顺序可以记成“先配头，后写正文，最后关闭”。

用固定时间和文件名生成可重复的 GZIP 流

写文件名时不要把当前机器的绝对路径塞进去，通常只保留归档内需要展示的相对名称。测试或内容寻址场景还应使用固定的 time.Time，避免每次生成结果都因为当前时间变化。

package main

import (
    "bytes"
    "compress/gzip"
    "fmt"
    "log"
    "time"
)

func main() {
    var buf bytes.Buffer
    zw := gzip.NewWriter(&buf)

    // 头字段必须在第一次 Write、Flush 或 Close 前设置。
    zw.Name = "report.txt"
    zw.ModTime = time.Date(2024, time.January, 2, 3, 4, 5, 0, time.UTC)

    // Write 只写正文；错误要立即处理，避免继续使用不完整的流。
    if _, err := zw.Write([]byte("daily report\n")); err != nil {
        log.Fatal(err)
    }
    // Close 会刷新未写出的压缩数据并写入 GZIP 尾部。
    if err := zw.Close(); err != nil {
        log.Fatal(err)
    }

    zr, err := gzip.NewReader(bytes.NewReader(buf.Bytes()))
    if err != nil {
        log.Fatal(err)
    }
    // Reader 的 Header 字段可用于核对压缩流携带的元数据。
    fmt.Println(zr.Name, zr.ModTime.UTC().Format(time.RFC3339))
    if err := zr.Close(); err != nil {
        log.Fatal(err)
    }
}

这个顺序有两个实际价值：固定时间让测试结果稳定，显式 Close 则保证压缩尾部完整。只调用 Write 后读取底层缓冲区，可能拿到尚未完成的 GZIP 数据。

用 gzip.Reader 读回并验证元数据

读取端在 gzip.NewReader 成功返回后，就可以访问 zr.Name 和 zr.ModTime。如果还要确认正文无误，应继续读取到 io.EOF；仅查看头字段不能替代正文和校验和检查。

// 读取端示例：同时核对头字段和解压正文。
var body bytes.Buffer
if _, err := io.Copy(&body, zr); err != nil {
    log.Fatal(err)
}
// 读到 EOF 后再把 Name、ModTime 当作完整流的核对结果。
fmt.Printf("%s %s %q\n", zr.Name, zr.ModTime.UTC().Format(time.RFC3339), body.String())

生产代码应在不再使用时关闭 Reader。Reader 的 Close 不会关闭底层输入；而 GZIP 校验和要在读完数据后才有机会被确认。

复用与边界：Reset、零值时间和字符串限制

如果通过 zw.Reset 复用 Writer，下一段数据开始前要重新设置 Name 和 ModTime，不要假设上一段的元数据会自动变成当前值。对于 ModTime，零值通常意味着不主动写入有效的修改时间；需要稳定元数据时应传入明确的 UTC 时间。

Name 和其他 GZIP 头字符串还受格式编码限制，不能随意放入任意 Unicode 字符。文件名应使用短、可移植的名称，并在跨平台归档中提前约定编码。若只关心解压后的正文，不要把头字段误当成文件系统权限、真实路径或完整文件属性。

常见问题

为什么设置了 Name 却读不到？最常见原因是设置发生在第一次 Write 之后，或者读取的是尚未 Close 完成的缓冲区。把头字段配置移到首次写入之前，并检查 Close 错误。

修改时间应该用本地时区吗？可以传入带时区的 time.Time，但归档和测试更适合统一使用 UTC，并在展示时明确格式。这样不同机器不会因为本地时区产生难以比较的结果。

速查：Name 管文件名，ModTime 管修改时间；二者都要在首次写入前设置；Close 负责完成流；复用 Reset 后重新赋值；需要验证正文时继续读到 EOF。