Go 压缩归档 zip Close 缺失中央目录怎么办

用 Go 的 archive/zip 写压缩归档时，文件条目写入成功并不代表 ZIP 已经完成。zip.Writer 会在 Close() 阶段写入中央目录和归档结束记录；如果只写条目、没有关闭 writer，读取端就可能提示“缺失中央目录”或把文件判定为损坏。

修复方式很明确：所有条目写完后调用 zipWriter.Close()，并处理它的返回错误。若输出目标是文件，还要在 writer 收尾后再关闭底层 os.File，这样才能区分压缩归档收尾失败和文件刷盘失败。

官方文档：https://pkg.go.dev/archive/zip

为什么少了 Close 就没有中央目录

ZIP 文件不是只有若干个本地文件头和压缩数据。读取端通常还要从文件尾部找到中央目录，借此快速定位每个条目的名称、偏移量、压缩大小和未压缩大小。zip.NewWriter 创建的是写入器，Create 或 CreateHeader 只负责登记并写入条目数据，中央目录要等所有条目确定后才能统一收尾。

因此，Close 在这里不是普通的资源清理动作，而是 ZIP 格式的一部分。忘记调用它时，前面的字节看起来可能正常，但文件末尾缺少读取端需要的目录记录。

最小修复：把 Close 放在所有条目之后

最小写法是把 Close 放在所有 Create 和写入操作之后，并且不要丢掉返回值：

package main

import (
    "archive/zip"
    "bytes"
    "fmt"
    "log"
)

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

    // Create 会登记一个 ZIP 条目，后续写入内容属于这个条目。
    entry, err := zw.Create("readme.txt")
    if err != nil {
        return nil, fmt.Errorf("创建 ZIP 条目失败: %w", err)
    }
    // 这里写入条目正文；示例使用内存缓冲区，便于演示收尾顺序。
    if _, err = entry.Write([]byte("archive/zip close demo\n")); err != nil {
        return nil, fmt.Errorf("写入 ZIP 条目失败: %w", err)
    }
    // Close 会补写中央目录和归档结束记录，不能忽略它的错误。
    if err = zw.Close(); err != nil {
        return nil, fmt.Errorf("关闭 ZIP writer 失败: %w", err)
    }
    return buf.Bytes(), nil
}

func main() {
    data, err := buildArchive()
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("ZIP bytes:", len(data))
}

这个版本的关键不是“多写了一行关闭代码”，而是把 Close 当作归档提交点：调用它之前，输出仍可能只有条目局部数据；调用成功后，读取端才有完整目录可用。

文件输出时，Close 的顺序和错误都要保留

写到 os.File 时容易出现两个误区：只关闭文件、不关闭 zip.Writer；或者用两个 defer 丢掉其中一个错误。更稳妥的做法是先关闭 ZIP writer，再关闭文件，并让命名返回值接住两个阶段的失败：

func writeZIP(path string) (err error) {
    f, err := os.Create(path)
    if err != nil {
        return fmt.Errorf("创建输出文件失败: %w", err)
    }
    // 文件关闭负责底层文件资源；真正的 ZIP 收尾由 zw.Close 完成。
    defer func() {
        if closeErr := f.Close(); err == nil && closeErr != nil {
            err = fmt.Errorf("关闭输出文件失败: %w", closeErr)
        }
    }()

    zw := zip.NewWriter(f)
    entry, err := zw.Create("data.txt")
    if err != nil {
        return fmt.Errorf("创建 ZIP 条目失败: %w", err)
    }
    // 条目写入错误要立即返回，避免继续生成不完整归档。
    if _, err = io.WriteString(entry, "payload\n"); err != nil {
        return fmt.Errorf("写入条目失败: %w", err)
    }
    // 先写中央目录，再让 defer 关闭底层文件。
    if err = zw.Close(); err != nil {
        return fmt.Errorf("ZIP 收尾失败: %w", err)
    }
    return nil
}

上面的示例还需要在文件顶部导入 archive/zip、fmt、io 和 os。如果文件关闭阶段报错而前面没有错误，命名返回值会把它保留下来；如果 ZIP 收尾已经失败，则不会被后续的文件关闭覆盖。

内存缓冲区和文件输出怎么选

如果归档需要追加多个条目，保持同一个 zip.Writer 直到所有条目写完；不要在每个条目后反复关闭再继续写。若 Close 返回错误，应保留并删除或隔离这个不完整文件，不能把它当成可下载结果。

常见问题

只调用 os.File.Close，为什么仍然报缺失中央目录？

因为 os.File.Close 只关闭底层文件，它不会替 zip.Writer 生成中央目录。必须显式调用 zw.Close()。

Close 成功后还需要 Flush 吗？

不需要把 Flush 当成最终收尾。对 zip.Writer 来说，完整归档的关键是成功执行 Close；写文件时再按顺序关闭底层文件即可。

记住一条判断：ZIP 条目写入完成，只说明数据段基本形成；zip.Writer.Close() 成功，才说明中央目录和归档结束记录已经写出。把它的错误纳入返回值，通常就能解决“文件能生成但读取失败”的问题。