Go io.SectionReader 怎样让 ReadAt 不改变当前读取位置

在一个文件或字节流的固定片段里做“先顺序读一段，再探测某个偏移，继续顺序读”的任务时，io.SectionReader 的 ReadAt 很容易被误解。直接结论是：ReadAt 的 off 是相对 section 起点的偏移，它不会推进 SectionReader 内部供 Read 使用的当前位置。

官方文档：https://pkg.go.dev/io@go1.27.3#SectionReader.ReadAt

先分清 SectionReader 保存的三个位置

调用 io.NewSectionReader(r, base, size) 后，可以把 section 想成底层数据上的一扇窗口。base 是窗口在底层输入中的起点，limit 是窗口的结束边界，内部的当前偏移则从 base 开始向前移动。Size() 返回的是窗口长度，不是底层输入的总长度。

因此，Read 的参数没有额外偏移：它从当前顺序位置开始读，并在成功读取后推进这个位置。ReadAt 的参数却是“相对窗口起点”的位置，方法内部会把它换算成底层的绝对偏移。两者使用同一个 section 边界，但不共享同一个推进动作。

用 ReadAt 探测内容而不打乱顺序读取

下面的例子先用 Read 消费 3 个字节，再用 ReadAt 查看 section 内相对偏移 5 的两个字节，最后继续调用 Read。最后一次顺序读取仍从第 4 个字节开始，说明中间的定位读取没有改变当前进度。

package main

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

func main() {
    // section 从底层字符串的第 5 个字节开始，只开放 10 个字节。
    source := strings.NewReader("0123456789ABCDEFGHIJ")
    section := io.NewSectionReader(source, 5, 10)

    first := make([]byte, 3)
    n, err := section.Read(first)
    if err != nil && err != io.EOF {
        panic(err)
    }

    probe := make([]byte, 2)
    // off=5 是 section 内偏移，不是底层字符串的绝对下标。
    m, probeErr := section.ReadAt(probe, 5)
    if probeErr != nil && probeErr != io.EOF {
        panic(probeErr)
    }

    next := make([]byte, 3)
    k, nextErr := section.Read(next)
    if nextErr != nil && nextErr != io.EOF {
        panic(nextErr)
    }

    // 预期关系：first 为 567，probe 为 AB，next 仍从 8 开始读取。
    fmt.Printf("%d %s | %d %s | %d %s\n", n, first, m, probe, k, next)
}

这里的关键不是把 ReadAt 当成“带 Seek 的 Read”，而是把它当成 section 内的独立定位读取。底层 ReaderAt 的契约也要求这种读取不影响底层 seek offset；如果业务需要多个 goroutine 并行读取，应确认底层实现满足对应的并发安全边界。

缓冲区超过 section 末尾时怎样判断

ReadAt 不会为了填满缓冲区越过 section。若请求的切片延伸到窗口末尾，实际读取长度会被截短，并返回已经读取的字节数和说明未能填满的错误。代码应先处理 n > 0 的数据，再根据 err 判断是不是正常到达 section 边界。

func readHeader(s *io.SectionReader, off int64) ([]byte, error) {
    buf := make([]byte, 8)
    // ReadAt 的 off 相对 section 起点，不能直接套用底层文件偏移。
    n, err := s.ReadAt(buf, off)
    if n > 0 {
        // 先保留已经读到的字节，避免因为 EOF 丢掉有效前缀。
        buf = buf[:n]
    }
    if err != nil {
        return buf, err
    }
    return buf, nil
}

什么时候用 Read，什么时候用 ReadAt

常见问题

ReadAt 的 off 能不能直接传底层文件偏移？

不能。它相对 SectionReader 的起点计算；如果 section 从底层偏移 4096 开始，想读底层 4106 的位置，应传 section 内偏移 10。

ReadAt 读完以后为什么下一次 Read 没有跳过去？

这是预期行为。ReadAt 只完成一次定位读取，不修改顺序读取位置；需要改变顺序位置时，应显式调用 Seek，并重新确认它仍位于 section 边界内。