Go archive/zip Copy 为什么不能修改文件头字段

Go 的 archive/zip.Writer.Copy 不能按你的要求修改文件头字段，根因不是字段不可导出，而是它的职责是把已有条目的原始编码直接搬到新归档。要改文件名、注释或其他元数据，应复制 FileHeader 后调用 CreateRaw；如果还要改内容、压缩方法或重新计算 CRC 与尺寸，就改用 Open、CreateHeader 和 io.Copy。

判断标准很简单：只想保留原压缩字节，选 CreateRaw；需要让 Writer 重新组织条目，选 CreateHeader。不要修改 f.FileHeader 后继续把 Copy 当成“带新头复制”。

Copy 为什么不适合改文件头

Copy 的参数只有一个从 Reader 得到的 *zip.File，它会绕过解压、重新压缩和校验，直接复制条目的原始形式。ZIP 条目同时包含本地文件头、压缩数据和中央目录记录，名称、Flags、Method、CRC32 以及压缩前后大小之间必须相互匹配。单独改内存中的字段，并不能同步修改原始数据段前面的本地头。

因此，问题通常不是“为什么导出的字段还是旧值”，而是调用路径选错了：Copy 是完整条目搬运接口，CreateRaw 才是“给新头、写原始压缩字节”的接口，CreateHeader 则是“给新头、写未压缩内容”的接口。

只改名称或注释时使用 CreateRaw

当原条目内容不变，只需要调整归档内路径或注释，可以复制头部再修改，使用 OpenRaw 取得未解压的字节。这样不会因为重新压缩改变压缩大小，但头部中的 CRC、方法和尺寸必须继续对应原始字节。

package main

import (
    "archive/zip"
    "io"
    "os"
)

func copyWithNewName(src, dst string) error {
    // 源 Reader 负责解析中央目录，目标 Writer 负责重新写中央目录。
    in, err := zip.OpenReader(src)
    if err != nil { return err }
    defer in.Close()

    outFile, err := os.Create(dst)
    if err != nil { return err }
    defer outFile.Close()
    out := zip.NewWriter(outFile)

    for _, f := range in.File {
        header := f.FileHeader // 复制，避免让 Writer 接管源对象
        header.Name = "renamed/" + f.Name
        raw, err := f.OpenRaw() // 保留原始压缩字节，不做解压
        if err != nil { return err }
        entry, err := out.CreateRaw(&header)
        if err == nil { _, err = io.Copy(entry, raw) }
        if err != nil { return err }
    }
    // Close 会写入中央目录，不能省略或只关闭底层文件。
    return out.Close()
}

这里的关键是 OpenRaw 与 CreateRaw 成对出现。若修改了 Method、CRC 或尺寸，却仍写入原压缩字节，目标归档就会出现无法解压或校验失败；修改目录名和注释时，通常应保留这些与内容相关的字段。

需要重算内容时使用 CreateHeader

如果你要过滤内容、替换正文、切换压缩方式，原始字节已经不能直接复用。此时从 f.Open() 取得解压流，复制头部后交给 CreateHeader，Writer 会依据实际写入内容生成新的尺寸与校验信息。

func rewriteEntry(src, dst string) error {
    // 重新写入会解压并再次编码，适合内容或压缩方式发生变化的场景。
    in, err := zip.OpenReader(src)
    if err != nil { return err }
    defer in.Close()

    file, err := os.Create(dst)
    if err != nil { return err }
    defer file.Close()
    out := zip.NewWriter(file)
    for _, f := range in.File {
        header := f.FileHeader
        header.Name = "normalized/" + f.Name
        header.Method = zip.Deflate // 让 Writer 重新压缩解压后的内容
        w, err := out.CreateHeader(&header)
        if err != nil { return err }
        r, err := f.Open()
        if err != nil { return err }
        // 复制完成后关闭读取流，避免长批次处理时积累资源。
        _, copyErr := io.Copy(w, r)
        closeErr := r.Close()
        if copyErr != nil { return copyErr }
        if closeErr != nil { return closeErr }
    }
    return out.Close()
}

选择方案时的边界检查

还要注意 ZIP 路径必须使用相对路径和正斜杠，不能把本地文件系统的反斜杠直接写进 FileHeader.Name。批量转换时，每个条目写完后再处理下一个，最后检查 Writer.Close；这个调用负责落中央目录，遗漏它会让归档看起来已经写入，实际却不完整。

常见疑问

能不能先修改 f.Name 再调用 Copy？ 不建议。Copy 的语义是原始复制，不是元数据重建；要改头部就显式复制 FileHeader 并选择 CreateRaw 或 CreateHeader。

CreateRaw 会不会自动校验压缩数据？ 不会。它按给定头部写入原始字节，因此只有在头部字段与这些字节一致时才适合使用。需要校验内容时，使用 Open 解压读取，再用 CreateHeader 重写。

总结

Copy 解决的是“原样搬运条目”，不是“带新文件头复制”。改元数据但保留压缩流，用复制后的 FileHeader 配合 OpenRaw/CreateRaw；改内容或压缩参数，用 Open/CreateHeader 让 Writer 重建一致的 ZIP 记录。这样既能解释字段修改不生效的原因，也能避开本地头、中央目录和 CRC 不一致的问题。