Go archive/zip.Reader怎样逐项读取压缩包内文件为什么结果为空或不符合预期

使用 archive/zip.Reader 逐项读取压缩包时，结果为空或不完整，通常不是 range 循环本身失效，而是 Reader 没有按正确方式构造、ZIP 中只有目录条目、文件大小传错，或者某个 File.Open() 错误被忽略。稳定的做法是先统计 Reader.File 的条目，再区分目录和文件，最后为每个文件单独打开、读取并关闭。

官方地址：https://pkg.go.dev/archive/zip

选择正确的 Reader 构造方式

如果输入是本地 ZIP 文件，zip.OpenReader 会打开文件并返回带关闭能力的 *zip.ReadCloser。如果数据已经位于实现了 io.ReaderAt 的内存或随机访问存储中，才使用 zip.NewReader(r, size)。第二个参数是整个 ZIP 的字节数，不是压缩包内某个文件的大小；传小会导致目录解析不完整，传大也会让尾部定位出现错误。

package main

import (
	"archive/zip"
	"fmt"
)

func countEntries(path string) error {
	r, err := zip.OpenReader(path)
	if err != nil {
		return fmt.Errorf("打开 ZIP 失败: %w", err)
	}
	defer func() {
		// ReadCloser 持有文件资源，函数退出前必须关闭。
		_ = r.Close()
	}()

	// File 同时包含目录和普通文件，先统计再决定读取策略。
	fmt.Printf("条目总数: %d\n", len(r.File))
	return nil
}

按 Reader.File 逐项读取，先排除目录条目

Reader.File 是 ZIP 条目的切片，顺序来自归档目录。判断目录时优先使用 f.FileInfo().IsDir()，而不是只看名称是否以斜杠结尾。对普通文件再调用 f.Open()，这样每个条目的错误都能单独定位。

func readZip(path string) (int, int, int64, error) {
	r, err := zip.OpenReader(path)
	if err != nil {
		return 0, 0, 0, fmt.Errorf("打开 ZIP 失败: %w", err)
	}
	defer r.Close()

	files, failed := 0, 0
	var bytesRead int64
	for _, f := range r.File {
		// 目录条目没有需要读取的正文，不能计入文件成功数。
		if f.FileInfo().IsDir() {
			continue
		}

		rc, err := f.Open()
		if err != nil {
			// 一个坏条目不应掩盖其他条目的结果。
			failed++
			continue
		}
		data, readErr := io.ReadAll(rc)
		closeErr := rc.Close()
		if readErr != nil || closeErr != nil {
			failed++
			continue
		}
		files++
		bytesRead += int64(len(data))
	}
	return files, failed, bytesRead, nil
}

这里的三个返回指标比“打印了几行”更可靠：files 表示成功读取的普通文件数，failed 表示打开、解压、校验或关闭阶段出现异常的文件数，bytesRead 表示真正交给调用方的未压缩字节数。生产代码还应把 f.Name 写进错误日志，便于定位具体条目。

为什么结果为空或不符合预期

需要按名字读取单个文件时，也可以使用 Reader.Open(name)，它遵循 fs.FS 的路径语义：路径使用正斜杠，不能带开头的 / 或 ../。但批量统计和排障仍建议先遍历 Reader.File，因为它能同时看到目录、文件名和每个条目的失败位置。

用可复现指标判断读取是否完整

排查时建议固定记录五个字段：条目总数、目录数、成功文件数、失败文件数和读取字节数。对同一份 ZIP 重复读取，前四项应稳定；如果只有字节数变化，优先检查是否把文本转换、解压后过滤或空文件处理混进了统计逻辑。

性能比较也应围绕同一组输入记录：例如固定 1000 个条目，分别记录总耗时、Open 失败数和总读取字节数。不要把“少打印了一些日志”当作读取更快；先确认成功文件数和字节数没有下降，再讨论缓冲、并发或复制成本。File.Open 会透明解压并校验校验和，若只需要原始压缩数据，才考虑文档中的 OpenRaw，两者不能混用结果口径。

常见问题

为什么能看到 ZIP 条目，却读不到文件内容？

最常见原因是条目本身是目录，或 File.Open 返回错误。先看 IsDir()，再记录每个条目的打开和读取错误。

zip.NewReader 的 size 能不能填压缩包内文件大小？

不能。size 必须是整个 ZIP 数据源的字节数；从内存切片构造时通常传 int64(len(data))。

读取完成后为什么还要关闭每个 ReadCloser？

File.Open 返回的读取器可能持有解压或底层资源。逐条关闭可以缩短资源占用，也能把关闭阶段的错误纳入失败统计。