Go archive/tar Reader Next 读到文件尾后怎样处理 EOF

在 Go 的 archive/tar 中，Reader.Next 返回的 io.EOF 才表示整个 tar 归档已经遍历结束；读取当前文件内容时，Reader.Read 返回的 io.EOF 只表示当前条目读完。两者都叫 EOF，但判断位置不同：外层循环判断 Next，条目内容循环判断 Read。

官方文档：https://pkg.go.dev/archive/tar#Reader.Next

最稳妥的写法是：收到 Next 的 io.EOF 就正常结束；收到其它错误就返回；拿到 Header 后，再决定是否把当前条目的内容读完。

先区分两种 EOF 的含义

tar 归档由多个顺序排列的条目组成。调用 Next 会前进到下一个条目并返回它的 Header；当所有条目都处理完时，Next 返回 io.EOF。而 Read 面向的是上一次 Next 选中的当前条目，当前文件的数据读完后才会报告该条目的 EOF。

因此，不能在读取某个文件内容时看到 EOF 就直接认为整个压缩包结束，也不能把 Next 的 EOF 当成异常重试。它是归档遍历的正常终点。

把 EOF 判断放在 Next 循环

遍历 tar 的核心是先调用 Next，再处理返回的头部。下面的函数只统计普通文件条目，演示如何把正常结束和真正的读取错误分开：

func countRegularFiles(src io.Reader) (int, error) {
	tr := tar.NewReader(src)
	count := 0
	for {
		header, err := tr.Next()
		if errors.Is(err, io.EOF) {
			// Next 返回 EOF 表示整个 tar 归档已经没有下一个条目。
			return count, nil
		}
		if err != nil {
			// 非 EOF 错误可能表示归档损坏或输入读取失败，不能吞掉。
			return 0, fmt.Errorf("读取 tar 条目失败: %w", err)
		}

		if header.Typeflag == tar.TypeReg {
			// 这里只统计普通文件；下一次 Next 会推进到下一个条目。
			count++
		}
	}
}

这里使用 errors.Is 而不是直接比较 err == io.EOF，可以保留包装错误的判断能力。正常末尾返回累计数量和 nil，其它错误则交给调用方决定是否记录、重试或终止任务。

读取当前条目时，EOF 只属于当前文件

拿到头部后，如果需要读取文件内容，可以用 io.Copy 或循环调用 Read。当前条目读完后出现 EOF 是内容边界，不需要把它升级成“归档结束”；真正决定是否还有下一个条目的动作仍然是下一次 Next。

func readEntryBody(tr *tar.Reader, dst io.Writer) error {
	if _, err := io.Copy(dst, tr); err != nil {
		// Copy 的 EOF 是当前条目内容自然结束，成功时不会把它作为错误返回。
		return fmt.Errorf("读取当前条目内容失败: %w", err)
	}
	// 当前条目已经复制完，调用方可以回到外层并再次调用 Next。
	return nil
}

如果业务只关心头部，不需要正文，也可以不主动把内容全部读出；随后调用 Next 时，archive/tar 会自动丢弃当前条目的剩余数据并继续定位下一个条目。这个行为不等于可以把当前条目的数据误当成下一个条目。

用边界表检查遍历逻辑

空文件也遵循同一规则：它有一个头部，但内容长度为零；处理完头部后，下一次 Next 才决定归档是否还有其它条目。不要用文件大小是否为零来判断整个归档是否结束。

常见误区与速查结论

第一，不要在 Read 返回 EOF 时直接跳出整个归档循环。第二，不要把 Next 的 EOF 当作损坏信号，它是 tar 迭代器的正常终点。第三，不要为了“清空”当前条目而手动猜测偏移，未读数据会在下一次 Next 时由 Reader 处理。

可以把判断压缩成三步：先调用 Next；若是 EOF，正常收尾；若拿到 Header，再按需读取当前条目；其它错误一律保留。这样就能同时处理普通文件、空文件、未读完条目和损坏输入。

相关问题

Reader.Read 返回 EOF 后还要再调用 Next 吗？要。它只表示当前条目内容已经读完，是否存在下一个条目由下一次 Next 判断。

不读取当前条目内容会影响下一个条目吗？不会。调用 Next 时 Reader 会自动丢弃当前条目的剩余数据，再定位到下一个条目。

为什么不建议只判断 err == io.EOF？使用 errors.Is 能识别被包装的 EOF，同时保持对其它错误的区分。