如何在 Go 中向现有 ZIP 文件追加文件？_技术教程

go 标准库不支持直接向已有 zip 文件追加文件，因为 zip 格式要求中央目录位于文件末尾且需整体重写；正确做法是解压、添加、重新压缩，或改用支持流式追加的格式（如 tar）。

在 Go 语言中，archive/zip 包提供了强大的 ZIP 文件读写能力，但它不支持“就地追加”文件到已有 ZIP 归档。原因在于 ZIP 文件结构的设计：中央目录（Central Directory）必须位于文件末尾，且所有条目偏移量需精确对齐。若直接在末尾追加数据，会导致中央目录失

效，使 ZIP 文件损坏或无法被标准解压工具识别。

✅ 正确做法：重建 ZIP 文件

你需要：

读取并解压原 ZIP 文件（提取所有已有文件）；
加入新文件（内存中或临时目录）；
创建新 ZIP 文件，将全部内容（原有 + 新增）一次性写入。

以下是一个完整示例：

package main

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

func appendToFileToZip(zipPath, filePath, zipFilePathInArchive string) error {
    // 1. 读取原始 ZIP 并提取所有文件（或仅元数据）
    oldZip, err := zip.OpenReader(zipPath)
    if err != nil {
        return err
    }
    defer oldZip.Close()

    // 2. 创建新 ZIP 文件（覆盖原文件或另存为新路径）
    newZipFile, err := os.Create(zipPath + ".tmp") // 避免中途失败破坏原文件
    if err != nil {
        return err
    }
    defer newZipFile.Close()

    newZip := zip.NewWriter(newZipFile)
    defer newZip.Close()

    // 3. 复制原有条目
    for _, f := range oldZip.File {
        rc, err := f.Open()
        if err != nil {
            return err
        }
        w, err := newZip.Create(f.Name)
        if err != nil {
            rc.Close()
            return err
        }
        if _, err = io.Copy(w, rc); err != nil {
            rc.Close()
            return err
        }
        rc.Close()
    }

    // 4. 添加新文件
    newFile, err := os.Open(filePath)
    if err != nil {
        return err
    }
    defer newFile.Close()

    w, err := newZip.Create(zipFilePathInArchive)
    if err != nil {
        return err
    }
    if _, err = io.Copy(w, newFile); err != nil {
        return err
    }

    // 5. 必须显式调用 Close() 写入中央目录
    if err = newZip.Close(); err != nil {
        return err
    }

    // 6. 原子替换（Linux/macOS）或重命名（Windows 兼容）
    if err = os.Rename(zipPath+".tmp", zipPath); err != nil {
        return err
    }

    return nil
}

func main() {
    err := appendToFileToZip("archive.zip", "newfile.txt", "docs/newfile.txt")
    if err != nil {
        panic(err)
    }
}