Go archive/zip 怎么处理超过 4GB 的 ZIP64 条目

直接答案：正常使用 zip.Writer.CreateHeader() 或 Create() 写入内容时，Go 标准库会在需要时自动加入 ZIP64 字段，不必手工拼 Extra。关键是使用 io.Copy 流式传输，不把整个文件读进内存；读取时使用 CompressedSize64 和 UncompressedSize64，不要依赖已弃用的 32 位大小字段。

先分清兼容字段和真实大小

FileHeader 同时保留 32 位与 64 位大小字段，是为了兼容传统 ZIP。普通条目中两组字段数值相同；当压缩后或未压缩大小无法放进 32 位字段时，CompressedSize 与 UncompressedSize 会写成 0xffffffff，真实数值放在对应的 64 位字段中。

用流式写入避免内存随文件增长

超过 4GB 的文件不适合先读入 []byte。创建条目 writer 后直接 io.Copy，内存占用主要由复制缓冲和压缩器决定，而不是由源文件总大小决定。FileInfoHeader 可从文件信息生成基础 header，但要补上归档内路径和压缩方法。

func addLargeFile(zw *zip.Writer, src *os.File, info fs.FileInfo) error {
    header, err := zip.FileInfoHeader(info)
    if err != nil {
        return err
    }
    header.Name = "backup/data.bin" // ZIP 内使用相对路径和正斜杠
    header.Method = zip.Deflate      // 需要压缩时显式指定方法

    entry, err := zw.CreateHeader(header)
    if err != nil {
        return err
    }
    // 直接从源文件复制到 ZIP 条目，不在内存中聚合全部数据
    _, err = io.Copy(entry, src)
    return err
}

CreateHeader 会接管 header，调用后不要再修改。一个条目的内容必须在创建下一个条目或关闭 Writer 前写完。

让 Writer 负责 ZIP64 元数据

标准库会统计实际写入字节，并在必要时加入 ZIP64 Extra；Writer.Close() 还会追加中央目录版本的 ZIP64 字段。因此正常压缩路径下，不要预先把 32 位字段强塞成截断后的值，也不要自己拼二进制 Extra。

归档收尾需要同时检查 ZIP Writer 和底层文件的关闭错误。zip.Writer.Close() 只完成 ZIP 结构，不会关闭传入的底层 writer；写本地文件时，调用方仍要关闭文件并处理错误。

func buildArchive(dst *os.File, src *os.File, info fs.FileInfo) error {
    zw := zip.NewWriter(dst)
    if err := addLargeFile(zw, src, info); err != nil {
        _ = zw.Close() // 尽力释放内部状态，保留原始写入错误
        return err
    }
    if err := zw.Close(); err != nil {
        return err // 中央目录或 ZIP64 元数据写入失败
    }
    return dst.Close() // zip.Close 不会关闭底层文件
}

读取和部署还要检查三个边界

读取归档时，展示大小、配额判断和进度计算都应使用 64 位字段。调用 File.Open() 可透明解压并校验校验和，不需要自己解析 ZIP64 Extra。

• 文件系统：输出位置必须支持大文件，并预留压缩后文件、临时空间和失败重试所需容量。
• 格式能力：archive/zip 支持 ZIP64，但不支持跨磁盘分卷；单个输出介质放不下时要换存储策略。
• 工具兼容：接收方必须支持 ZIP64。面向旧设备或旧解压工具时，应先用代表性大文件做兼容测试。

常见问题

必须提前知道未压缩大小吗？

正常使用 Create 或 CreateHeader 写入时不必手工计算 ZIP64 Extra，Writer 会根据实际写入量维护大小与目录信息。使用 CreateRaw 写已压缩字节时，调用方才需要提供一致的 CRC 和大小元数据。

看到 0xffffffff 是文件损坏吗？

不一定。对 ZIP64 条目，这是传统 32 位字段的占位标记；应继续读取对应的 64 位字段判断真实大小。