Go archive/zip 怎样给 ZIP 条目设置压缩方法

用 Go 的 archive/zip 创建压缩包时，单个 ZIP 条目的压缩方法由 zip.FileHeader.Method 决定。要保留原样写入，设置为 zip.Store；要使用标准库内置的 Deflate，设置为 zip.Deflate，然后把数据写入 CreateHeader 返回的 io.Writer。方法选择和压缩级别是两层配置，不要混为一谈。

最小可用规则：每个条目先准备自己的 FileHeader，设置 Method，调用 CreateHeader 写完内容；整个 ZIP 最后调用 Writer.Close。

用 FileHeader.Method 选择条目方法

FileHeader 描述 ZIP 中的一个条目，Method 是其中的压缩方法字段。Store 不压缩，适合已经压缩过的 JPEG、PNG、ZIP 或希望读取开销尽量低的内容；Deflate 适合文本、JSON、日志等有重复结构的内容。下面这张图是 API 关系说明图，不是运行截图或运行结果。

这里的“给条目设置压缩方法”，不是给整个 zip.Writer 设置一个全局开关。每次创建条目都可以有自己的 FileHeader，因此同一个 ZIP 可以让文本使用 Deflate，让图片使用 Store。

用 CreateHeader 写入 Store 或 Deflate 条目

下面的示例把文本和 PNG 模拟数据放进同一个压缩包。代码重点是：设置方法后再调用 CreateHeader，写入返回的 writer，并检查每一步错误；最终的 Close 会写入 ZIP 中央目录。

package main

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

func addEntry(w *zip.Writer, name string, method uint16, data []byte) error {
    // FileHeader 只描述当前条目，方法不会自动影响下一个条目。
    header := &zip.FileHeader{Name: name, Method: method}
    entry, err := w.CreateHeader(header)
    if err != nil {
        return fmt.Errorf("创建 %s: %w", name, err)
    }
    // 条目必须在创建下一个条目或关闭 ZIP 前写完。
    if _, err := io.Copy(entry, bytes.NewReader(data)); err != nil {
        return fmt.Errorf("写入 %s: %w", name, err)
    }
    return nil
}

func main() {
    file, err := os.Create("assets.zip")
    if err != nil {
        panic(err)
    }
    defer file.Close() // 释放文件描述符；ZIP 目录由 zipWriter.Close 写入。

    zipWriter := zip.NewWriter(file)
    if err := addEntry(zipWriter, "readme.txt", zip.Deflate, []byte("重复文本更适合 Deflate。")); err != nil {
        panic(err)
    }
    if err := addEntry(zipWriter, "photo.png", zip.Store, []byte("已经压缩过的内容示意")); err != nil {
        panic(err)
    }
    if err := zipWriter.Close(); err != nil {
        panic(err)
    }
}

在这个例子里，readme.txt 和 photo.png 的方法互不影响。Method 的零值等价于 Store，但生产代码仍建议显式写出方法，阅读代码时能直接看出意图。

需要统一压缩级别时注册 Deflate 压缩器

如果需求只是“这个条目要不要压缩”，设置 FileHeader.Method 就够了。如果需求变成“所有 Deflate 条目使用某个 flate 压缩级别”，可以在 zip.Writer 上调用 RegisterCompressor(zip.Deflate, ...)。这仍然只影响选择了 zip.Deflate 的条目，不能让 zip.Store 突然产生压缩。

package main

import (
    "archive/zip"
    "compress/flate"
    "io"
)

func configureDeflate(zipWriter *zip.Writer) {
    // 只替换 Deflate 的压缩器；Store 条目不会经过这里。
    zipWriter.RegisterCompressor(zip.Deflate, func(out io.Writer) (io.WriteCloser, error) {
        // BestSpeed 偏向写入速度；需要更小体积时可改成 BestCompression。
        return flate.NewWriter(out, flate.BestSpeed)
    })
}

RegisterCompressor 接收的是方法编号和一个创建压缩 writer 的函数。创建出来的 writer 必须由 ZIP writer 管理的写入过程正确关闭；不要在回调里把底层输出 writer 关掉。若只需要标准默认行为，不必注册自定义压缩器，直接使用 zip.Deflate 即可。

四个容易混淆的边界

如果生成的 ZIP 无法被完整读取，优先检查是否提前进入下一个条目、是否忽略了写入错误，以及是否遗漏了 zip.Writer.Close。如果只是压缩率不理想，先确认条目确实用了 Deflate，再考虑压缩级别；对 JPEG、PNG 这类已有压缩的数据，改成 Deflate 往往只会增加处理成本。

相关问题

Go archive/zip 的 Store 和 Deflate 怎么选？ 文本和日志通常优先 Deflate，已经压缩的媒体文件通常优先 Store。

能不能只给一个 ZIP 条目设置高压缩？ 可以为该条目选择 Deflate，并通过自定义注册器统一影响所有 Deflate 条目；若要不同条目使用不同压缩级别，通常需要拆分 writer 或采用更细的压缩器管理策略。

为什么设置了 Method 但包体积没明显变小？ 可能是数据本身已经压缩、样本太短，或实际仍使用了 Store；Method 只声明条目的方法，不保证任何输入都能得到更小文件。