Go io.NewSectionReader 怎么读取文件切片：Offset、Seek 与越界返回

处理日志、分片文件或归档包时，常见需求不是把整个数据源读进内存，而是只拿其中一段。Go 的 io.NewSectionReader 可以在实现了 io.ReaderAt 的数据源上建立一个固定窗口：窗口从 Offset 开始，最多读取指定长度，读到边界后自然得到 EOF。

把 NewSectionReader 当成“带边界的局部读取器”：Read 受窗口当前位置影响，ReadAt 使用窗口内偏移，Seek 不能把游标移到窗口起点之前。

先把 NewSectionReader 看成一扇固定宽度的窗口

io.NewSectionReader(r, off, n) 接收一个 ReaderAt、底层起点 off 和窗口长度 n。它不会复制数据，也不会改变底层读取器，只是在外面保存 base、当前 off、limit 等边界。

例如字符串 0123456789ABCDEFGHIJ 从偏移 10 开始截取 5 个字节，窗口看到的是 ABCDE。这里的 0、10、5 分别属于底层数据、窗口起点和窗口长度，别把它们混成“从第 10 个字节读取 5 次”。

用 bytes.Reader 验证局部读取和 EOF

package main

import (
    "bytes"
    "fmt"
    "io"
)

func main() {
    source := bytes.NewReader([]byte("0123456789ABCDEFGHIJ"))
    section := io.NewSectionReader(source, 10, 5)

    buf := make([]byte, 8)
    n, err := section.Read(buf)
    fmt.Printf("n=%d data=%q err=%v size=%d\n", n, buf[:n], err, section.Size())

    n, err = section.Read(buf)
    fmt.Printf("n=%d err=%v\n", n, err)
}

第一次 Read 虽然给了 8 字节缓冲区，但窗口只有 5 字节，所以最多返回 ABCDE。下一次读取时当前位置已经到达窗口末尾，结果是 n=0 和 io.EOF。这就是窗口限制生效的证据。

ReadAt 的偏移从窗口内部重新计数

section.ReadAt(buf, 0) 读取的是窗口起点，也就是底层数据的 ABCDE，不是底层偏移 0 的 01234。实现内部会把窗口内偏移加回 base，再调用底层 ReaderAt.ReadAt。

当传入的窗口偏移等于 section.Size()，它已经位于窗口外，直接得到 io.EOF。如果缓冲区跨过窗口尾部，返回已读字节数并带上 EOF，调用方应优先处理 n，不要因为有错误就丢掉有效片段。

Seek 的边界：能回退，但不能穿过窗口起点

SectionReader.Seek 支持 io.SeekStart、io.SeekCurrent 和 io.SeekEnd。返回值是相对窗口的偏移，所以 Seek(0, io.SeekStart) 返回 0，而不是底层的 base。

窗口起点由 base 保存，窗口终点由 limit 保存。尝试把游标移到 base 之前时，Seek 返回 errOffset；它不会替你把位置钳制到 0。相反，向窗口末尾之后定位并不等于立刻报错，下一次 Read 才会因为 off >= limit 返回 EOF。

几个容易写错的使用场景

• 底层数据源只实现了 io.Reader：不能直接传给 NewSectionReader，应改用实现 ReaderAt 的类型或设计明确的索引读取层。
• 把窗口长度当成全局文件长度：Size() 返回的是当前切片大小，不能用它推断底层数据源总量。
• 并发共享同一个 SectionReader：Read 和 Seek 会改变同一个游标；并发场景更适合每个任务各建一个窗口，并使用独立的 ReadAt 偏移。

相关问题

NewSectionReader 会复制底层数据吗？

不会。它保存底层 ReaderAt 和边界，实际字节仍由底层读取器提供。

为什么 ReadAt 到窗口末尾会返回 EOF？

因为窗口长度就是 Size()，从这个位置开始已经没有可读字节；跨过尾部时也只返回窗口内实际读到的部分。

需要读取连续区间时应该用 Read 还是 ReadAt？

单线程顺序消费可用 Read；需要并发、重试或多个固定位置时，用独立窗口配合 ReadAt 更容易保持偏移清晰。

最后的判断清单

只要先确认数据源满足 ReaderAt，再明确底层起点 off 和窗口大小 n，SectionReader 的行为就很稳定：顺序读取看游标，随机读取看窗口内偏移，边界结果看 EOF。测试时至少覆盖窗口首字节、窗口尾部、越界 ReadAt 和越过 base 的 Seek。