Go io.SectionReader.Size 与当前偏移为什么无关

io.SectionReader.Size() 返回的是 section 在创建时确定的总长度，不是“从当前游标到末尾还剩多少字节”。所以即使已经调用过 Read，或者用 Seek 把当前位置移到了中间，Size() 仍然保持不变。要判断剩余长度，需要把 section 长度与当前相对位置分开保存。

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

Size 记录的是创建时的 section 长度

SectionReader 不是把底层 reader 截短后返回一个普通游标，而是保存了一组边界：起点 base、当前偏移 off 和结束位置 limit。官方源码中的 Size 实现就是 s.limit - s.base，因此它天然与 off 无关。

例如 io.NewSectionReader(r, 4, 10) 的逻辑区间长度就是 10。这里的 4 是底层数据中的起始绝对偏移，10 是暴露给调用方的 section 长度。读取了 3 字节以后，剩余长度虽然可以按“10 - 当前相对偏移”计算，但这不是 Size() 的职责。

用最小示例区分 Read、Seek 和 Size

package main

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

func main() {
	// section 从底层字符串的第 4 个字节开始，逻辑长度固定为 10。
	r := strings.NewReader("0123abcdefghijXYZ")
	s := io.NewSectionReader(r, 4, 10)

	buf := make([]byte, 3)
	if _, err := s.Read(buf); err != nil {
		// Read 失败时不要继续使用不完整的数据。
		panic(err)
	}

	// Read 推进当前偏移，但 Size 仍然表示整个 section 的长度。
	pos, err := s.Seek(0, io.SeekCurrent)
	if err != nil {
		panic(err)
	}
	fmt.Printf("data=%q pos=%d size=%d\\n", buf, pos, s.Size())

	// ReadAt 的 off 是 section 内相对偏移，不消费上面的顺序游标。
	random := make([]byte, 2)
	if _, err := s.ReadAt(random, 5); err != nil {
		panic(err)
	}
	fmt.Printf("random=%q size=%d\\n", random, s.Size())
}

示例中第一次 Read 后，pos 变成 3，但 size 仍是 10；随后 ReadAt 从 section 内相对位置 5 读取，也不会把顺序位置从 3 推到 7。若业务需要剩余长度，可以明确写成 s.Size() - pos，并先处理负值或越界情况。

Read、Seek 与 ReadAt 只改变或绕过当前偏移

可以把三种操作按“是否使用顺序游标”分开：

• Read：从当前 off 开始读，成功读取多少就把 off 向后推进多少；到达 limit 后返回 io.EOF。
• Seek：根据 io.SeekStart、io.SeekCurrent 或 io.SeekEnd 重新定位 off，返回值是相对 section 起点的位置。
• ReadAt：把传入位置解释成 section 内相对偏移，再映射到底层 reader；它服务于随机读取，不依赖也不推进顺序游标。

因此，SeekEnd(0) 得到的是 section 末端的相对位置，也就是 Size() 的值；这说明两者数值可能相等，但语义不同：一个是当前定位结果，一个是固定容量。

实际使用时的边界与复用方式

分段解析文件或协议数据时，建议把 Size() 当作边界，把当前位置当作进度。若需要读取 section 剩余内容，可先通过 Seek(0, io.SeekCurrent) 获取相对位置，再计算 remaining := s.Size() - pos，并在调用前确认 remaining >= 0。

同一个 SectionReader 适合单条顺序读取流程；如果多个任务需要独立游标，应为每个任务创建自己的 reader，或统一使用 ReadAt 并让底层 ReaderAt 满足并发访问要求。嵌套创建新的 section 时，新 reader 的 Size() 是新边界的长度，不会反映外层 reader 当前已经读到哪里。

常见问题

Size 会随着 Read 减少吗？
不会。它返回整个 section 长度；要得到剩余长度，使用明确的“总长度减当前位置”计算。

ReadAt 的位置是底层文件绝对偏移吗？
不是。传给 ReadAt 的位置相对于 section 起点，SectionReader 会自动加上创建时的 off。