Go tar.Reader 如何跳过目录条目后解压文件

用 Go 解压 tar 时，目录条目不是需要复制的文件内容。遍历 tar.Reader 后，先看 Header 的类型：目录直接跳过，普通文件才把当前 Reader 复制到目标文件；符号链接、硬链接和设备节点则按业务策略跳过或单独处理。关键是不要因为跳过目录就跳出循环，下一次 Next() 才会继续读取后面的条目。

为什么目录条目可以直接跳过

archive/tar 是流式 Reader。每次调用 Next() 得到一个 *tar.Header，随后对同一个 Reader 的读取只对应这个条目的数据。官方文档还规定，目录、链接和其他特殊类型调用 Read 时会直接得到 io.EOF，所以目录没有可供解压的正文。

判断目录时可以使用 hdr.FileInfo().IsDir()；判断普通文件时，推荐再检查 hdr.FileInfo().Mode().IsRegular()。这比只看文件名末尾的斜杠更稳，因为条目类型由 Header 表达。tar.TypeDir、tar.TypeReg、tar.TypeSymlink 等常量适合在需要区分链接策略时使用。

把目录判断放进安全解包函数

下面的函数只解压普通文件。目录不创建成普通文件，链接和特殊节点也不跟随写入；这样示例边界比较清楚，后续若要恢复符号链接，可以在单独的策略分支中处理。

package main

import (
    "archive/tar"
    "fmt"
    "io"
    "os"
    "path/filepath"
)

func extractRegularFiles(src io.Reader, dest string) error {
    tr := tar.NewReader(src)
    for {
        hdr, err := tr.Next()
        if err == io.EOF {
            return nil // 所有条目都已读完，正常结束。
        }
        if err != nil {
            return fmt.Errorf("读取 tar 条目失败: %w", err) // 损坏头部不能继续猜测。
        }

        info := hdr.FileInfo()
        if info.IsDir() {
            continue // 目录只有元数据；下一轮 Next 会继续推进归档流。
        }
        if !info.Mode().IsRegular() {
            continue // 不跟随符号链接、硬链接或设备节点写入宿主机。
        }

        name := filepath.FromSlash(hdr.Name)
        if !filepath.IsLocal(name) {
            return fmt.Errorf("拒绝非本地归档路径: %q", hdr.Name) // 防止写出 dest。
        }
        target := filepath.Join(dest, name)
        if err := os.MkdirAll(filepath.Dir(target), 0755); err != nil {
            return fmt.Errorf("创建父目录失败: %w", err)
        }

        out, err := os.OpenFile(target, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, info.Mode().Perm())
        if err != nil {
            return fmt.Errorf("创建文件 %q 失败: %w", target, err)
        }
        _, copyErr := io.Copy(out, tr) // 这里只复制当前普通文件的数据。
        closeErr := out.Close()       // 每轮显式关闭，避免大量条目耗尽句柄。
        if copyErr != nil {
            return fmt.Errorf("写入 %q 失败: %w", target, copyErr)
        }
        if closeErr != nil {
            return fmt.Errorf("关闭 %q 失败: %w", target, closeErr)
        }
    }
}

这里的 continue 只结束当前循环体，不会消耗下一条记录；下一次回到 tr.Next() 时，Reader 会处理当前条目剩余部分并前进。普通文件分支中的 io.Copy 也不需要手动按 Header.Size 截断，Reader 会把读取范围限制在当前条目内。

三个容易漏掉的边界

还要注意，官方文档对 Next 的安全路径提示只验证文件名，不验证链接目标。因此即使程序允许保留链接元数据，也不要默认把链接目标直接创建到宿主机。对于来自不可信来源的 tar，最小安全策略通常是只落盘普通文件，并限制解压目录权限。

解压后怎么快速核对结果

不需要把目录当成输出文件去统计。可以按下面的清单复查：普通文件数量是否与预期一致；每个文件的相对路径是否仍位于 dest 下；空文件是否正常创建；归档末尾是否以 io.EOF 结束；遇到链接或特殊节点时日志是否明确记录“跳过”而不是静默跟随。

常见问题

跳过目录后还需要调用 io.Copy 吗？

不需要。目录没有正文数据，直接进入下一轮 Next() 即可。

为什么不能只判断 Name 是否以斜杠结尾？

名称只是展示字段，条目类型应以 Header 的类型信息为准；使用 FileInfo 或 Typeflag 能把目录、普通文件和链接分开。

io.Copy 会不会把下一个文件也读进去？

不会。tar.Reader 按当前 Header 的大小限制读取，读到当前条目末尾就返回 EOF，下一条内容要等下一次 Next() 才能访问。