Go zip压缩包目录条目为空时的遍历兼容方案

遇到“ZIP 里明明有 docs/readme.txt，遍历却找不到 docs/”时，先不要把它当成 Go 的目录读取故障。ZIP 目录条目本来就可以缺省，archive/zip 的 Reader.File 返回的是归档条目列表；只有 FileHeader.Name 以 / 结尾时，才能把该条目当作显式目录。兼容做法是：把文件条目当作事实来源，按斜杠拆分路径补出父目录，同时对归档路径做安全检查。

先把目录条目和文件条目分开判断

ZIP 的中心目录记录可以只保存文件名，例如 docs/readme.txt，并不强制额外保存 docs/ 这一行。相反，某些压缩工具会同时写入目录条目，形成两种都合法的输入。Go 文档把 FileHeader.Name 末尾的斜杠作为目录信号，因此遍历时应区分“显式目录”和“文件路径隐含的目录”。

遍历条目并按路径补齐隐式目录

目录视图不应依赖某个压缩工具的习惯。下面的示例用两个集合保存目录和文件，遇到文件就从末尾向上登记父目录；显式目录和隐式目录最终会自然去重。

package main

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

// safeArchiveName 按 ZIP 使用的斜杠路径检查基本边界。
func safeArchiveName(name string) bool {
	if name == "" || strings.HasPrefix(name, "/") || strings.Contains(name, "\\") {
		return false
	}
	for _, part := range strings.Split(name, "/") {
		// 拒绝父级跳转，避免后续落盘时逃出目标目录。
		if part == ".." || part == "." {
			return false
		}
	}
	return true
}

func parent(path string) string {
	if i := strings.LastIndexByte(path, '/'); i >= 0 {
		return path[:i]
	}
	return ""
}

func collect(r *zip.Reader) (map[string]struct{}, map[string]struct{}, error) {
	dirs := map[string]struct{}{}
	files := map[string]struct{}{}
	for _, entry := range r.File {
		name := strings.TrimSuffix(entry.Name, "/")
		if !safeArchiveName(name) {
			return nil, nil, fmt.Errorf("不安全的 ZIP 路径: %q", entry.Name)
		}
		if name == "" {
			continue
		}
		if strings.HasSuffix(entry.Name, "/") {
			dirs[name] = struct{}{}
		} else {
			files[name] = struct{}{}
		}
		// 即使压缩包没有写入 docs/，也从文件路径补出它的父目录。
		for p := parent(name); p != ""; p = parent(p) {
			dirs[p] = struct{}{}
		}
	}
	return dirs, files, nil
}

这里的 dirs 是业务视图，不是 ZIP 原始记录的复刻。若应用只需要列文件，可以省略目录集合；若要展示树形目录、统计目录大小或创建落盘目录，则应保留这层补齐逻辑。

在打开文件时处理资源和安全边界

File.Open 返回的是需要关闭的 io.ReadCloser。只对非目录条目打开，并把 Close 放在处理当前文件的局部函数里，避免在大循环中累积大量延迟关闭的句柄。路径检查也要使用归档的斜杠语义，不要直接把未检查的 Name 拼到宿主机输出目录。

func readEntries(r *zip.Reader) error {
	for _, entry := range r.File {
		if strings.HasSuffix(entry.Name, "/") {
			continue // 目录条目没有文件内容可读。
		}
		if !safeArchiveName(entry.Name) {
			return fmt.Errorf("拒绝路径: %q", entry.Name)
		}
		if err := func() error {
			rc, err := entry.Open()
			if err != nil {
				return err
			}
			defer rc.Close() // 每个条目处理完立即释放读取资源。
			// 在这里读取并写入经过安全映射的目标路径。
			return nil
		}(); err != nil {
			return fmt.Errorf("读取 %s: %w", entry.Name, err)
		}
	}
	return nil
}

Go 当前文档还提示，OpenReader 和 NewReader 会关注非本地名称、反斜杠和 zipinsecurepath 行为。应用自己的解压逻辑仍应保留明确的业务检查，因为“能被库读到”不等于“允许写入目标目录”。

用测试样例验证三种 ZIP 形态

兼容代码至少要覆盖三组样例：第一组同时包含 docs/ 与 docs/readme.txt；第二组只包含后者，用来证明隐式目录会被补齐；第三组包含 ../escape.txt、绝对路径或反斜杠，确认函数返回错误而不是继续落盘。测试断言应分别检查目录集合、文件集合和错误结果，避免只断言最终生成了一个文件。

相关问题

为什么不能用 entry.FileInfo().IsDir() 代替 Name 判断？

它只能判断当前条目是否被声明为目录，不能凭空创建压缩包没有写入的父目录。缺目录条目时，仍要从文件路径推导目录视图。

目录条目能不能调用 Open？

不建议。目录条目表示结构，不是需要读取的文件内容；按末尾斜杠跳过即可。

为什么每个条目都要及时 Close？

Open 返回的读取器带有资源生命周期。大批量遍历时把关闭动作限定在单条目函数内，能避免句柄和底层读取资源持续累积。

这样处理后，目录是否作为独立 ZIP 条目存在只影响原始记录，不再影响应用的遍历结果；文件条目、补齐的目录视图、资源关闭和路径拒绝各自有清晰边界，后续换压缩工具或输入来源时也更容易回归。