archive/tar Reader.Next 如何跳过填充数据

用 Go 读取 tar 归档时，Reader.Next 会负责把当前条目剩余的数据和块填充跳过去，再返回下一个 Header。因此，调用方不必自己计算填充长度；只要在处理完当前条目后继续调用 Next，读取位置就能落在下一个条目的边界上。

但这不代表可以忽略读取错误：当前文件的数据仍然要通过 Read、io.Copy 或其他读取方式消费，Next 返回的 io.EOF 只表示整个归档结束。下面只讨论 archive/tar 的文件流，不涉及外层压缩。

先分清 Header、Read 和 Next 的职责

tar.NewReader 建立的是一个顺序读取器。每次调用 Next，它都会返回当前要处理的条目头；拿到头以后，Reader 本身就像一个只指向该条目数据的 io.Reader。

• Header 描述名称、类型和逻辑大小，Header.Size 是当前文件数据的字节数。
• Read 只读取当前条目的数据，读到该条目末尾时会返回 io.EOF，直到下一次调用 Next。
• Next 切换到下一个条目；当前数据没有读完时，剩余数据会被自动丢弃。

这里最容易混淆的是两个 io.EOF：Read 的 EOF 表示当前条目没有更多数据，Next 的 EOF 才表示整个归档已经结束。遍历代码应当把这两个位置分开处理。

Next 为什么能越过填充数据

tar 条目由头部、文件数据和块填充组成。文件数据长度不一定刚好落在块边界上，所以一个短文件后面可能紧跟着若干填充字节。Reader.Next 知道当前头部声明的 Size，会先处理当前条目还剩多少数据，再处理为了对齐而存在的填充，最后寻找下一个条目的头。

所以调用方不应该根据 Header.Size 自己推导“还要跳多少字节”。这种做法容易在短读、特殊条目或格式扩展出现时与读取器状态脱节。正确的边界动作是：要读取就从 tr 读，要切换条目就调用 Next。

最小遍历循环：先判断 Next，再读取当前文件

下面的循环把归档结束、读取下一个头失败和当前条目数据读取失败分开。示例使用 io.Copy 把当前条目完整消费掉；如果业务需要落盘，可把目标替换成已打开并准备好的文件。

package main

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

// walkTar 顺序读取每个条目，并把条目数据消费到指定目标。
func walkTar(src io.Reader, dst io.Writer) error {
    tr := tar.NewReader(src)

    for {
        hdr, err := tr.Next()
        if err == io.EOF {
            // Next 的 EOF 表示整个 tar 归档已经没有下一个条目。
            return nil
        }
        if err != nil {
            // 头部解析失败时不能把它当成正常结束。
            return fmt.Errorf("读取 tar 头部失败: %w", err)
        }

        // Header 只描述当前条目，真正的内容仍要从 tr 读取。
        if _, err := io.Copy(dst, tr); err != nil {
            // 数据流错误与归档结束是两类不同问题。
            return fmt.Errorf("读取 %q 的内容失败: %w", hdr.Name, err)
        }
    }
}

如果目标只是统计或丢弃内容，可以把 dst 换成 io.Discard。关键点不在于使用哪一个目标，而在于不要把 Header 当作已经读完文件：头部和文件数据是两个不同的读取阶段。

只读一部分内容时，让 Next 负责收尾

有些场景只需要读取文件前缀，例如先识别文本编码，再决定是否完整保存。此时可以故意只读取一部分，然后直接调用 Next。读取器会丢弃当前条目尚未消费的部分以及对应填充，调用方不需要再调用 Seek，也不应把 tar 输入强行断言成支持随机访问的文件。

// readPrefix 只取当前条目前缀，剩余字节交给后续 Next 自动跳过。
func readPrefix(tr *tar.Reader, limit int64) ([]byte, error) {
    if limit 

这个模式适合“只看一部分、不保存当前文件”的任务。若业务确实需要完整内容，应当使用 io.Copy 或循环读取到当前条目结束；不要因为 Next 会自动跳过，就把完整内容读取误写成只读前缀。

安全边界：路径错误和填充跳过不是一回事

归档遍历常常会进一步落盘，风险通常来自条目名称，而不是填充字节。当前 Go 文档说明：当不接受非本地文件名时，Next 可能返回带有 tar.ErrInsecurePath 的头部；这类错误不能当成普通 EOF，也不能继续把该名称直接拼接到目标目录。

// nextLocalHeader 只接受本地路径语义，避免把路径风险混同为归档结束。
func nextLocalHeader(tr *tar.Reader) (*tar.Header, error) {
    hdr, err := tr.Next()
    if err == io.EOF {
        // 没有下一个条目，才是归档的正常结束。
        return nil, io.EOF
    }
    if errors.Is(err, tar.ErrInsecurePath) {
        // 拿到头部也不能直接落盘，先交给上层决定拒绝或隔离。
        return hdr, fmt.Errorf("拒绝非本地路径 %q: %w", hdr.Name, err)
    }
    if err != nil {
        // 其他头部错误需要保留原始错误，便于定位损坏归档。
        return nil, fmt.Errorf("读取下一个条目失败: %w", err)
    }
    return hdr, nil
}

上面示例还需要在 import 中加入 errors。实际解包时，还应使用明确的目标根目录和路径清理策略；这里的重点是边界判断：io.EOF 表示遍历结束，ErrInsecurePath 表示需要安全决策，二者不能合并。

一张表记住三个结束点

可以把遍历逻辑压缩成一句话：Header 用来判断当前条目是什么，Read 用来消费当前条目，Next 用来完成条目边界并寻找下一个 Header。只要不手动计算填充、不混淆两个位置的 EOF，顺序读取就会保持在正确的归档边界上。

常见追问

调用 Next 前一定要把当前文件读完吗？

不一定。当前条目未读完时，Next 会自动丢弃剩余数据并处理填充；但如果业务需要文件完整内容，仍然必须先把当前流消费完。

为什么不直接按 Header.Size 调用 Seek？

tar 的输入只要求实现 io.Reader，并不保证支持随机访问。Next 已经掌握条目边界和格式细节，交给它处理比调用方自行计算更稳妥。

Read 返回 io.EOF 后还能继续调用 Next 吗？

可以。该 EOF 表示当前条目数据读完；继续调用 Next 才能进入下一个条目或得到归档级 EOF。

ErrInsecurePath 是不是表示 tar 已经读完？

不是。它是路径安全策略产生的错误，需要单独处理；不要把它和 io.EOF 合并为“没有更多文件”。