Go 怎样读取文件中的固定区间而不移动共享游标

我在处理一个需要“只看文件中间一段”的场景时，最初想到的是先把底层文件定位到起点，再读取指定长度。这个办法会让共享的文件游标一起移动；当同一个文件还要被其他逻辑读取时，调用方之间就容易互相影响。对支持 io.ReaderAt 的数据源，Go 更适合用 io.NewSectionReader 把区间封装成一个独立的读取视图。

这篇只讨论固定区间的读取语义：offset 决定区间从哪里开始，length 决定最多能读多少字节；Read 在这个局部视图内前进，ReadAt 使用相对偏移但不移动它的 Read 游标。

官方地址：https://pkg.go.dev/io#NewSectionReader

需要读取文件固定区间时，把实现了 io.ReaderAt 的对象传给 io.NewSectionReader(r, offset, length)。之后的读取都被限制在这段范围内，不必先移动底层共享游标；区间读完后按 io.Reader 语义返回 io.EOF。

先把固定区间声明清楚

NewSectionReader 的参数是 ReaderAt、起始偏移和区间长度。它返回的不是一份复制出来的新字节，而是对底层数据源的一层固定范围包装。也就是说，创建它的成本主要是保存这三个边界，真正的数据仍在读取时从底层对象取出。

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	source := strings.NewReader("header|payload-2026|footer")

	// 从第 7 个字节开始，只把 payload-2026 这一段暴露给读取器。
	section := io.NewSectionReader(source, 7, 11)

	data, err := io.ReadAll(section)
	if err != nil {
		// ReadAll 只把真正的读取错误返回给调用方。
		panic(err)
	}

	fmt.Printf("%q, size=%d\n", data, section.Size())
}

这里的区间是从底层字符串的第 7 个字节开始，长度为 11。SectionReader 只会把这 11 个字节当作自己的输入；即使底层对象前面还有 header|，后面还有 |footer，它们也不会被这个视图读出来。

有一个很关键的接口约束：构造函数接收的是 io.ReaderAt，不是普通的 io.Reader。原因是固定区间的每次读取都要能根据绝对位置取数据，而不是依赖一个会被前后调用改变的共享位置。*os.File 和 *strings.Reader 都提供了所需能力，网络流这类只有顺序读取能力的对象则不能直接这样包装。

用 Read 按区间游标顺序读取

把 SectionReader 当作普通 io.Reader 使用时，Read 的游标从区间起点开始，而不是从底层文件当前游标开始。连续调用会在这个固定窗口内向前推进；它不会为了读取区间而调用底层对象的 Seek。

func readHeaderPart(source io.ReaderAt) ([]byte, error) {
	// 这里把文件开头的 16 个字节作为一个局部读取视图。
	section := io.NewSectionReader(source, 0, 16)
	buf := make([]byte, 6)
	var result []byte

	for {
		n, err := section.Read(buf)
		if n > 0 {
			// 只追加本次实际读到的字节，避免把缓冲区旧内容带入结果。
			result = append(result, buf[:n]...)
		}
		if err == io.EOF {
			// 到达固定区间末尾是正常结束，不需要继续重试。
			break
		}
		if err != nil {
			return nil, err
		}
	}
	return result, nil
}

这段循环的边界只由区间长度决定。即使底层文件还有更多内容，section.Read 也不会越过 16 字节的窗口。读取最后一小段时可能同时得到 n > 0 和 io.EOF，所以实际代码应先处理已经读到的字节，再判断错误。

从调用方体验看，这比直接对 *os.File 调用 Seek 更容易组合：一个函数可以持有自己的 SectionReader，另一个函数仍然可以从同一个文件对象读取其他位置。这里的“不移动共享游标”是 SectionReader 使用 ReadAt 访问底层数据带来的语义；它不等于自动保证所有底层操作都能无锁并发，是否并行安全仍要看具体对象和调用方式。

用 ReadAt 读取局部偏移

ReadAt 的偏移是相对于 SectionReader 的起点，而不是整个文件的绝对位置。假设区间从文件偏移 100 开始，那么 section.ReadAt(buf, 4) 实际读取的是文件偏移 104 附近的数据。

func readTwoFields(source io.ReaderAt) (string, string, error) {
	// 只观察文件偏移 100 到 139 的 40 字节，不改变底层共享位置。
	section := io.NewSectionReader(source, 100, 40)
	first := make([]byte, 8)
	second := make([]byte, 8)

	if _, err := section.ReadAt(first, 0); err != nil {
		// 第一个字段必须完整存在，否则把错误交给上层处理。
		return "", "", err
	}
	if _, err := section.ReadAt(second, 16); err != nil {
		// 16 是区间内的相对偏移，不是底层文件的绝对偏移。
		return "", "", err
	}
	return string(first), string(second), nil
}

连续两次 ReadAt 彼此独立，也不会改变之后调用 section.Read 的位置。这种语义适合读取定长文件头、索引记录或已经知道偏移的字段：调用方不需要先把读取器退回某个位置。

不过，ReadAt 仍然遵循固定长度读取的边界。如果请求的字节数超过区间剩余长度，返回值中的 n 可能小于缓冲区长度，并伴随 io.EOF。因此需要“必须完整读满”的场景时，应检查 n，或者根据记录格式使用 io.ReadFull 并处理它的错误。

用 Size、Seek 和错误边界收尾

SectionReader 提供了三个容易混淆但用途不同的能力：

• Size() 返回创建时指定的区间长度，不代表底层文件当前总大小。
• Seek() 调整的是 SectionReader 内部的局部游标，io.SeekStart 的 0 表示区间起点。
• ReadAt() 不改变 Read() 使用的局部游标，偏移也是相对区间起点计算。

func readFromMiddle(source io.ReaderAt) ([]byte, error) {
	// 区间长度是 12；局部位置 3 对应底层起点之后的第 3 个字节。
	section := io.NewSectionReader(source, 20, 12)
	if section.Size() != 12 {
		return nil, fmt.Errorf("unexpected section size: %d", section.Size())
	}

	if _, err := section.Seek(3, io.SeekStart); err != nil {
		// SeekStart 的坐标原点是区间开头，而不是底层文件开头。
		return nil, err
	}
	data, err := io.ReadAll(section)
	if err != nil {
		return nil, err
	}
	return data, nil
}

上面调用 Seek(3, io.SeekStart) 后，最多还能读取 9 个字节。若使用 io.SeekCurrent，偏移则相对于当前局部游标；若尝试把位置移到区间起点之前，应该把返回的错误当作调用失败处理。

长度参数也值得单独留意。它是一个字节数，不是字符数、行数或结构体数量；如果区间落在 UTF-8 文本的多字节字符中间，读取结果可能不是完整的字符。对于二进制格式，应该先根据格式定义计算字节偏移和长度；对于文本，读取完后再决定如何处理编码边界。

我通常会把固定区间的调用约定写成下面这张速查表：

常见问题

io.NewSectionReader 会复制文件中的那段内容吗？

不会。它创建的是一个带边界的读取视图，数据仍然按需从底层 ReaderAt 读取。若需要缓存或独立内存副本，应显式把数据读入自己的切片。

为什么参数必须是 io.ReaderAt？

因为区间读取需要根据绝对位置取数据，而不是依赖共享的顺序游标。只有 io.Reader 的流式对象没有这个随机读取能力，不能直接传入构造函数。

ReadAt 读到区间末尾时一定返回 EOF 吗？

当请求跨过可读区间时，通常会返回已经读到的字节数和 io.EOF。如果请求恰好读完最后一段，具体是否同时返回 EOF 要结合 ReaderAt 的接口语义处理，不能只用错误值忽略 n。

SectionReader 能替代文件锁吗？

不能。它解决的是读取范围和游标隔离问题，不负责多个 goroutine 对同一个底层对象进行读写时的业务同步。需要并发访问时，还要按底层对象的安全约束设计锁或任务分工。

参考资料地址：

• https://pkg.go.dev/io#NewSectionReader：构造固定区间读取器及参数语义。
• https://pkg.go.dev/io#SectionReader：Read、ReadAt、Seek、Size 与示例。
• https://go.dev/doc/：Go 官方文档入口。