Go archive/zip.OpenReader 怎么按名称读取压缩包文件

用 Go 按名称读取 ZIP 内的文件，需要分清两个“名称”：zip.OpenReader(zipPath) 接收磁盘上的压缩包路径；打开成功后，再调用 r.Open(memberName)，其中 memberName 是归档内部使用斜杠分隔的相对路径，例如 docs/readme.txt。返回的成员文件和 ZIP 归档都要关闭。

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

OpenReader 打开的是归档，不是归档内文件

zip.OpenReader 返回 *zip.ReadCloser。这个类型一边持有底层 ZIP 文件的关闭能力，一边嵌入 zip.Reader，因此可以直接调用 r.Open("docs/readme.txt")。Reader.Open 使用 fs.FS.Open 的名称语义，返回一个 fs.File；它本身又实现读取与关闭接口。

一个可直接复用的按名称读取函数

下面的函数读取一个文本或小型二进制成员，并用 io.LimitReader 限制最多读取的字节数。上限不是 ZIP 解压安全的全部措施，但能避免调用方无条件把超大成员一次性装入内存。

package zipread

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

func ReadMember(zipPath, memberName string, maxBytes int64) ([]byte, error) {
    // OpenReader 打开磁盘上的 ZIP 文件，并返回需要关闭的归档句柄。
    archive, err := zip.OpenReader(zipPath)
    if err != nil {
        return nil, fmt.Errorf("打开 ZIP 归档: %w", err)
    }
    defer archive.Close()

    // Open 按归档内部的斜杠相对路径查找成员。
    member, err := archive.Open(memberName)
    if err != nil {
        return nil, fmt.Errorf("打开归档成员 %q: %w", memberName, err)
    }
    defer member.Close()

    // 多读 1 字节用于判断内容是否超过业务允许的内存上限。
    data, err := io.ReadAll(io.LimitReader(member, maxBytes+1))
    if err != nil {
        return nil, fmt.Errorf("读取归档成员 %q: %w", memberName, err)
    }
    if int64(len(data)) > maxBytes {
        return nil, fmt.Errorf("归档成员 %q 超过 %d 字节上限", memberName, maxBytes)
    }
    return data, nil
}

调用时写 ReadMember("assets.zip", "docs/readme.txt", 1。如果返回成功，字节切片只对应这个成员；如果成员不存在，包装后的错误链仍保留底层 fs.ErrNotExist，调用方可以使用 errors.Is 判断。

成员名称必须使用归档内路径规则

Reader.Open 不是按本机文件系统路径查找。成员名始终使用正斜杠，不能以斜杠开头，也不能包含 .. 路径段。Windows 调用方同样应传 docs/readme.txt，不要传 docs\readme.txt。如果名称来自用户输入，可以先用 fs.ValidPath 拒绝明显不合法的值。

func normalizeMemberName(name string) (string, error) {
    // ZIP 成员名遵循 fs.FS 的正斜杠相对路径规则。
    name = strings.TrimSpace(name)
    if !fs.ValidPath(name) {
        return "", fmt.Errorf("无效的 ZIP 成员名 %q", name)
    }
    return name, nil
}

fs.ValidPath(".") 是合法的文件系统根名称，但它通常不代表业务想读取的普通成员；如果接口只允许具体文件，可以再显式拒绝 "."。路径合法也不等于成员存在，存在性仍由 archive.Open 判断。

把不存在、目录和不安全归档分开处理

成员不存在时，Reader.Open 会返回可与 fs.ErrNotExist 匹配的错误。若名称指向目录，返回值仍是文件接口，但读取通常不会得到普通文件内容；业务只允许文件时，可以调用 Stat 检查 IsDir。

member, err := archive.Open(memberName)
if errors.Is(err, fs.ErrNotExist) {
    // 成员名合法，但归档中没有这个文件。
    return nil, ErrMemberMissing
}
if err != nil {
    return nil, err
}
defer member.Close()

info, err := member.Stat()
if err != nil {
    return nil, err
}
if info.IsDir() {
    // 当前接口只接受普通成员，不把目录当成空文件读取。
    return nil, ErrMemberIsDirectory
}

zip.ErrInsecurePath 是另一层问题：当启用相应的 GODEBUG 行为后，如果归档本身包含非本地名称或反斜杠名称，OpenReader 可能同时返回一个 reader 和 ErrInsecurePath。面向不可信归档时，不要因为 reader 非空就忽略错误；最稳妥的默认策略是关闭已返回的 reader 并拒绝该归档。

什么时候遍历 Reader.File 更合适

名称已知且只读少量成员时，r.Open(name) 最直接。需要模糊匹配、忽略大小写、读取重复名称、查看压缩方法或未压缩尺寸时，则遍历 r.File 更合适，因为每个 *zip.File 暴露完整 FileHeader。注意 ZIP 可以包含重复名称，按名称打开只适合“名称唯一”这一业务约束明确的归档。

相关问题

为什么不能把绝对路径传给 Reader.Open？

它实现的是 fs.FS 风格的归档内名称查找，不是操作系统路径访问。名称必须是以正斜杠分隔的相对路径。

读取成员后只关闭 ZIP 可以吗？

不建议。成员文件和归档句柄是不同资源，按“先成员、后归档”的顺序分别关闭，代码的生命周期最清楚。

怎样读取内存中的 ZIP？

使用 zip.NewReader(readerAt, size)。它需要实现 io.ReaderAt 的数据源和总大小，后续仍可调用返回值的 Open(name)。

读取大成员一定要 io.ReadAll 吗？

不需要。若目标是解析、上传或写入其他存储，优先把 member 当作流交给解码器或 io.Copy，避免把完整内容留在内存中。