Go archive/zip 怎么把压缩包作为 fs.FS 读取

可以直接把 *zip.Reader 当作 fs.FS 使用。Go 的 archive/zip 已为 Reader 提供 Open(name)，因此读取 ZIP 内文件时不必遍历 []*zip.File。磁盘压缩包用 zip.OpenReader，内存数据用 zip.NewReader，得到对象后统一交给 fs.ReadFile、fs.ReadDir 或 fs.Sub。

核心取舍是把 ZIP 视为只读文件系统：业务代码只依赖 fs.FS，归档来自磁盘还是内存由创建阶段决定。

zip.Reader 为什么能作为 fs.FS

fs.FS 只要求实现 Open(name string) (fs.File, error)。zip.Reader 已提供这个方法；zip.ReadCloser 内嵌 Reader，因此从文件打开后也可直接传给接受 fs.FS 的函数。它是只读视图，不负责修改、追加或删除归档内容。

从磁盘 ZIP 读取文件和目录

下面的函数只在入口处接触 archive/zip。归档打开后，正文读取全部走 io/fs；这样以后换成 embed.FS、os.DirFS 或测试用文件系统时，调用层无需改写。

package main

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

func readArchive(path string) error {
    zr, err := zip.OpenReader(path)
    if err != nil {
        return fmt.Errorf("打开 ZIP: %w", err)
    }
    // zip.OpenReader 持有底层文件句柄，必须在读取结束后关闭。
    defer zr.Close()

    // ZIP 内部路径以归档根目录为起点，不要写成 /config/app.json。
    data, err := fs.ReadFile(zr, "config/app.json")
    if err != nil {
        return fmt.Errorf("读取配置: %w", err)
    }
    fmt.Printf("配置长度：%d 字节\n", len(data))

    // ReadDir 返回按文件名排序的目录项，适合列举固定目录。
    entries, err := fs.ReadDir(zr, "templates")
    if err != nil {
        return fmt.Errorf("列出模板目录: %w", err)
    }
    for _, entry := range entries {
        fmt.Println(entry.Name(), entry.IsDir())
    }
    return nil
}

如果只需一个文件，也可以调用 zr.Open("config/app.json")，但必须关闭返回的 fs.File。使用 fs.ReadFile 时，打开和关闭由辅助函数完成，调用代码更短。

内存 ZIP 与子目录视图

zip.NewReader 接收 io.ReaderAt 和归档总长度。bytes.Reader 同时满足随机访问要求，所以很适合 HTTP 已下载内容、对象存储返回值或测试夹具。若业务只应看到归档里的 assets，再用 fs.Sub 收窄根目录。

package archive

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

func readAsset(zipData []byte) ([]byte, error) {
    source := bytes.NewReader(zipData)
    zr, err := zip.NewReader(source, int64(len(zipData)))
    if err != nil {
        return nil, fmt.Errorf("解析 ZIP: %w", err)
    }

    // 把 assets 设为新根目录，调用方不再拼接 assets/ 前缀。
    assetsFS, err := fs.Sub(zr, "assets")
    if err != nil {
        return nil, fmt.Errorf("创建 assets 视图: %w", err)
    }

    data, err := fs.ReadFile(assetsFS, "theme/default.css")
    if err != nil {
        return nil, fmt.Errorf("读取主题文件: %w", err)
    }
    return data, nil
}

路径和错误处理要注意什么

传给 fs.ReadFile、fs.ReadDir 和 Open 的名称应符合 fs.ValidPath：使用正斜杠、不能以斜杠开头，也不要包含空段、. 或 ..。因此应写 docs/readme.txt，而不是 /docs/readme.txt 或本机绝对路径。

• 文件不存在：可用 errors.Is(err, fs.ErrNotExist) 判断，不要比较错误文本。
• 磁盘资源：zip.OpenReader 返回的 ReadCloser 要关闭；zip.NewReader 本身没有 Close。
• 读取大文件：fs.ReadFile 会把内容整体放入内存；需要流式处理时使用 Open 后交给 io.Copy。
• 只读边界：fs.FS 读取接口不会替代 zip.Writer；修改归档仍需重新写出。

把参数声明成 fs.FS 是更实用的 API 设计：生产环境可以传 ZIP，测试传 fstest.MapFS，目录部署则传 os.DirFS。真正需要 ZIP 特有元数据时，再在归档适配层访问 zip.File，不要把这种依赖扩散到整个业务层。

常见问题

zip.Reader 能配合 fs.WalkDir 吗？可以。它还提供目录读取能力，能够作为 fs.ReadDirFS 使用，直接传给 fs.WalkDir 遍历归档树。

为什么带前导斜杠的路径读取失败？io/fs 使用相对根目录的有效路径，/config/app.json 不符合规则，应改成 config/app.json。

什么时候仍要遍历 zr.File？当你需要压缩方法、CRC、原始大小、修改时间等 ZIP 专属头信息时，遍历 File 更直接；只读正文内容时优先使用 fs.FS 接口。