Go io.SectionReader.Size 与当前偏移为什么无关
io.SectionReader.Size() 返回的是 section 在创建时确定的总长度,不是“从当前游标到末尾还剩多少字节”。所以即使已经调用过 Read,或者用 Seek 把当前位置移到了中间,Size() 仍然保持不变。要判断剩余长度,需要把 section 长度与当前相对位置分开保存。
官方地址:https://pkg.go.dev/io
NewSectionReader(r, off, n)建立从off开始、最多覆盖n字节的读取区间。Size()表示固定区间长度;Read和Seek改变当前偏移,不改变区间长度。ReadAt使用 section 内相对偏移,适合随机读取;它不应该被当成顺序游标的推进操作。
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。
Redis Vector Set 怎么保存并检索相似向量
- 上一篇
- Redis Vector Set 怎么保存并检索相似向量
- 下一篇
- 米坛知识库产品百科开放贡献吗?公告、教程与开发者入口说明
-
- Golang · Go问答 | 24分钟前 | 标准库 · 事务 · database/sql · Go问答 · Go 事务 isolation database/sql readonly TxOptions BeginTx
- Go database/sql TxOptions 的 ReadOnly 和 Isolation 怎么配合
- 443浏览 收藏
-
- Golang · Go问答 | 30分钟前 | 标准库 · 连接池 · database/sql · Go问答 · Go 连接池 database/sql 连接生命周期 sql.Conn Conn.Close ErrConnDone
- Go database/sql.Conn.Close 后连接怎样回到连接池
- 426浏览 收藏
-
- Golang · Go问答 | 41分钟前 | 标准库 · HTTP · Go问答 · Go 重复请求头 MIMEHeader.Values 首个值 textproto.MIMEHeader.Get 请求头大小写
- Go textproto.MIMEHeader.Get 为什么只返回一个请求头值
- 300浏览 收藏
-
- Golang · Go问答 | 54分钟前 | 结构体 · 标准库 · 错误处理 · Go问答 · Go io.ErrUnexpectedEOF encoding/binary.Read 结构体空白字段 协议填充 binary.Size
- Go encoding/binary.Read 怎样处理结构体中的空白字段
- 330浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · Go math/big big.Int Float.IsInt Float.Int64
- Go math/big.Float.IsInt 为什么不能用来判断能否转成 int64
- 358浏览 收藏
-
- Golang · Go问答 | 1小时前 | 标准库 · Go问答 · Go 位运算 位图 math/bits bits.Len64
- Go math/bits.Len64 为什么适合计算位图宽度
- 235浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · math/big.Rat.Scan fmt.Scanner Go有理数
- Go math/big.Rat.Scan 的 %f 与 %v 为什么采用相同读取规则
- 270浏览 收藏
-
- Golang · Go问答 | 1小时前 | 接口 · go · Go格式化 fmt.Formatter fmt.Stringer
- Go fmt.Formatter 为什么会覆盖默认字符串格式化
- 405浏览 收藏
-
- Golang · Go问答 | 1小时前 | 切片 · 标准库 · Go问答 · Go encoding/binary AppendUint32 binary.LittleEndian 小端字节序
- Go binary.LittleEndian.AppendUint32 怎样向缓冲区追加整数
- 327浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1109次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1101次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1272次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1215次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1061次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览

