Go zip.Writer.AddFS 怎么把 fs.FS 写进压缩包

可以。Go 1.22 起，archive/zip.Writer 提供了 AddFS(fsys fs.FS)，它会从文件系统根目录遍历文件，把相对路径保留到 ZIP 中，并使用 Deflate 写入。最小写法是先用 os.DirFS 得到目录型 fs.FS，调用 AddFS，最后按“先关闭 ZIP、再关闭文件”的顺序收尾。

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

如果源目录是 assets/，想让压缩包从 index.html 和 css/app.css 开始，就把 os.DirFS("assets") 作为 AddFS 的输入；不要把宿主机绝对路径直接当成归档路径。

用 AddFS 把目录树写成 ZIP

AddFS 接收的是 fs.FS，不是裸字符串目录。os.DirFS("assets") 会把 assets 设为文件系统根，因此 ZIP 内不会出现宿主机上的完整路径。

package main

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

func main() {
    // 创建目标文件；ZIP Writer 关闭前不能关闭底层文件。
    out, err := os.Create("assets.zip")
    if err != nil {
        panic(err)
    }
    defer func() {
        // 这里处理底层文件的关闭错误，ZIP 的 Close 已经在前面完成。
        if err := out.Close(); err != nil {
            fmt.Println("关闭目标文件失败:", err)
        }
    }()

    zw := zip.NewWriter(out)
    // assets 是归档根，AddFS 会保留其内部的相对目录结构。
    if err := zw.AddFS(os.DirFS("assets")); err != nil {
        panic(err)
    }
    // Close 会写入 ZIP 中央目录；不能省略或只关闭 out。
    if err := zw.Close(); err != nil {
        panic(err)
    }
}

这段代码的目录关系是确定的：assets/index.html 会进入 index.html，assets/static/app.css 会进入 static/app.css。AddFS 本身会遍历根目录，目录结构被保留，文件内容按 Deflate 写入。

用 fs.Sub 控制压缩包里的路径前缀

有时源项目是 project/public，但发布包只需要公共目录里的内容。此时可以先用 fs.Sub 缩小文件系统视图，再交给 AddFS。这样既不改动源目录，也不会把 project/public 这段宿主机层级带入 ZIP。

package main

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

func writePublicZip(outPath string) error {
    // 以 project 为视图根，再选择 public 子目录作为归档根。
    root := os.DirFS("project")
    publicFS, err := fs.Sub(root, "public")
    if err != nil {
        return err
    }

    out, err := os.Create(outPath)
    if err != nil {
        return err
    }
    defer out.Close() // 只负责最后关闭底层文件，先由 zw.Close 写中央目录。

    zw := zip.NewWriter(out)
    if err := zw.AddFS(publicFS); err != nil {
        // AddFS 失败时尽力结束 Writer，原始错误仍返回给调用方。
        _ = zw.Close()
        return err
    }
    return zw.Close()
}

调用 writePublicZip("release.zip") 后，project/public/index.html 在包内显示为 index.html。如果希望保留 public/ 这一层，就不要做 fs.Sub，而是把包含它的目录视图直接传给 AddFS。

AddFS 的文件类型与关闭边界

AddFS 对目录创建目录条目，对普通文件读取内容并写入 ZIP；官方实现遇到非普通文件时会返回错误。因此不要把“能被 fs.FS.Open 打开”理解成“必然能被归档”。符号链接、设备文件等特殊类型要在进入归档前单独决定处理策略。

另一个常见误区是只检查 AddFS。ZIP 的中央目录由 Writer.Close 写入，关闭失败同样意味着产物不能交付。Writer.Close 不会替你关闭底层 io.Writer，所以资源顺序应当是：

常见问题

AddFS 生成的 ZIP 为什么没有源目录名？因为传入的是文件系统视图的根，归档只看到根下的相对路径；用 fs.Sub 还能进一步裁剪前缀。

能不能省略 zw.Close？不能。它负责写中央目录；即使文件内容已经写入，缺少中央目录也不应把结果当成完成的 ZIP。

AddFS 能处理符号链接吗？不要默认可以。官方实现要求条目是目录或普通文件，非普通文件会返回错误；需要链接语义时应先转换为明确的文件内容或单独设计归档格式。