Go io.SectionReader.Outer 怎样读取原始 Reader 和范围

我在处理分段文件读取时，最容易把 SectionReader 当成“已经移动到某个位置的 Reader”。真正需要记录的往往不是当前读到哪里，而是这个读取窗口最初来自哪个 ReaderAt、从原始数据的哪个偏移开始、最多允许读取多少字节。Go 的 io.SectionReader.Outer 就是为这个追溯场景准备的。

直接答案：调用 r, off, n := section.Outer()，可以拿回创建该窗口时传入的底层 ReaderAt、起始偏移和长度；这三个值不会随着后续 Read 或 Seek 改变，也不会返回当前游标。

官方文档：https://pkg.go.dev/io#SectionReader.Outer

我第一次用 Outer 时，先要搞清它返回什么

SectionReader 是对底层 ReaderAt 做出的一个“受限窗口”。创建时传入的 off 是相对底层数据的绝对起点，n 是这个窗口的最大长度。Outer 返回的正是这三个创建参数：底层对象、起点和长度。

它的价值在于保留来源信息。例如一层解析器只拿到了 *io.SectionReader，需要把错误位置映射回原文件时，可以先取出 off，再把窗口内偏移加回去。这里的“加回去”是应用层位置换算，不是 Outer 自动完成的。

SectionReader 的声明结构和范围

官方文档说明，NewSectionReader 从 ReaderAt 的 off 开始读取，并在 n 字节后以 EOF 结束。Read、ReadAt 和 Seek 负责消费这个窗口，Size 只返回窗口长度，而 Outer 负责找回来源元数据。

最小写法：读取原始 Reader 与原始范围

下面的例子只展示元数据关系。Outer 返回的第一个值仍是 io.ReaderAt 接口，调用方可以保存它，也可以根据自己的需要做类型断言；它不会把接口自动变成 *strings.Reader。

package main

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

func main() {
    source := strings.NewReader("header|payload-001|tail")
    section := io.NewSectionReader(source, 7, 11)

    outer, off, n := section.Outer()
    // 中文注释：Outer 返回创建窗口时的来源、绝对起点和最大长度。
    fmt.Printf("source=%T off=%d size=%d\n", outer, off, n)
    // 中文注释：Size 只描述窗口大小，与 Outer 返回的 n 相同。
    fmt.Println("window-size=", section.Size())
}

这个窗口从原始字符串的第 7 个字节开始，长度为 11。即使后面先调用 section.Seek 改变当前读取位置，Outer 再次返回的 off 和 n 仍然是 7 和 11。需要当前游标时，应该读取 Seek 的返回值，不能把它和 Outer 混用。

支持边界与工程取舍

Outer 在 Go 1.22.0 加入。如果项目需要兼容更早版本，代码不能直接调用它；可以在创建窗口的同时自行保存 ReaderAt、off 和 n，或者把这些元数据放进自己的结构体。

还有三个容易踩到的边界：

• 它不复制底层 ReaderAt。返回的是创建时传入的同一个来源接口，底层对象的生命周期仍由原拥有者负责。
• 它不返回窗口内数据。要读内容仍然调用 Read 或 ReadAt；要查看边界可以用 Size。
• 它不保证并发安全。Go 的 io 包文档没有把底层 I/O 原语默认承诺为可并行使用；是否能并发调用，要看具体 ReaderAt 实现。

对我来说，最稳妥的用法是把 Outer 当成“来源元数据出口”：日志、解析错误定位和分段任务追踪使用它；真正的读取动作仍交给 Read、ReadAt 或 Seek。这样既能保留原始范围，也不会误把元数据接口当成数据接口。

常见问题

Outer 返回的 off 是当前读取位置吗？

不是。它是创建 SectionReader 时传给 NewSectionReader 的起始偏移。当前顺序读取位置由 Seek 管理，二者用途不同。

Outer 返回的 n 和 Size 有什么区别？

在这个类型上，它们都能表达窗口长度；Outer 还同时返回来源和起始偏移，适合做范围追溯，Size 更适合只需要长度的调用点。

小结：需要回答“这段数据来自哪里、从哪里开始、窗口有多大”时用 Outer；需要回答“当前读到哪里”时看 Seek；需要读取内容时继续使用 Read 或 ReadAt。