Go bytes.Reader 如何从指定偏移量开始读取

想让 bytes.Reader 从指定偏移量开始读，最常用的写法是先调用 Seek(offset, io.SeekStart)，再调用 Read。例如偏移量为 6，就把当前位置移动到第 7 个字节。若只是临时读取一段数据而不想改变当前位置，应改用 ReadAt；若希望后续代码只能看到某个子范围，才考虑切片。

一、先分清 Seek、切片和 ReadAt

这三个写法都能“从某个位置取数据”，但含义并不一样。Seek 适合一个 Reader 按顺序读多个区段；它会修改内部当前位置，下一次 Read 从新位置继续。切片适合建立一个范围受限的视图，例如 data[offset:]，但切片后的 Reader 会把新数据的开头当成偏移 0。ReadAt 适合并行或随机读取，它每次都把传入位置当作相对原始数据的绝对字节偏移。

二、用 Seek 把当前位置移到指定偏移

下面的例子把当前位置移动到 6，再读取 5 个字节。bytes.NewReader 接收的是字节切片；io.SeekStart 表示从数据开头计算偏移。

package main

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

func main() {
	data := []byte("header-body-tail")
	r := bytes.NewReader(data)

	// 从原始数据开头计算，定位到第 7 个字节。
	pos, err := r.Seek(6, io.SeekStart)
	if err != nil {
		// 负偏移或无效 whence 都应停止后续读取。
		panic(err)
	}

	buf := make([]byte, 5)
	n, err := r.Read(buf)
	// Read 返回 n 个有效字节；末尾不足时要按 n 截取结果。
	if err != nil && err != io.EOF {
		panic(err)
	}
	fmt.Printf("pos=%d n=%d text=%q\n", pos, n, buf[:n])
}

这个例子中，pos 为 6，读取结果是 "-body"。注意 Seek 的返回值是新的当前位置，不是本次读取的字节数；真正的读取长度要看 Read 返回的 n。如果后面还要继续读取，游标会停在 11。

三、只读一次时用 ReadAt

如果函数只想从偏移 6 复制 5 个字节，不希望影响同一个 Reader 的后续顺序读取，可以直接使用 ReadAt。它的偏移参数相对整个 Reader 的起点计算。

buf := make([]byte, 5)

// ReadAt 不改变 r 的当前位置，适合独立读取固定区间。
n, err := r.ReadAt(buf, 6)
if err != nil && err != io.EOF {
	// 其他 I/O 错误不能被当成“正常读到末尾”。
	panic(err)
}

// n 可能小于 len(buf)，只使用实际读到的字节。
fmt.Printf("n=%d text=%q\n", n, buf[:n])

一个容易混淆的地方是：ReadAt 读到数据末尾时可能同时返回部分数据和 io.EOF。所以不能用“只要有错误就丢弃 buf”，应先依据 n 处理有效内容，再根据业务决定是否把读不满视为失败。

四、边界情况决定最终写法

• 偏移等于长度：Seek 可以定位到末尾，但后续 Read 读不到内容；这不等于定位失败。
• 偏移超过长度：Seek 可以把位置移到数据末尾之外，读取时得到 EOF；如果业务不允许，应先比较 offset > int64(r.Len())。
• 负偏移：从 io.SeekStart 计算出的负位置会返回错误，不能继续使用新的位置。
• 中文或二进制协议：偏移按字节计算。若要按字符定位，先明确 UTF-8 解码策略，不能直接把字符下标当成字节下标。

实际选择可以压缩成一句话：需要改变后续读取位置就用 Seek，需要保留 Reader 游标就用 ReadAt，需要把前缀永久排除在当前视图外才用切片。若要在定位前拒绝越界偏移，应拿它和原始数据的 len(data) 比较，而不是和已经移动后的剩余长度混用。

相关问题

Seek 后为什么 Read 读到 EOF？

通常是目标偏移已经等于或超过数据长度。检查 Seek 返回位置、r.Len() 和实际 n，不要只看是否调用成功。

bytes.Reader 的偏移是字符下标吗？

不是，是字节偏移。ASCII 文本看起来与字符位置一致，但 UTF-8 中文通常一个字符占多个字节。

ReadAt 读不满时应该重试吗？

先判断是否到达数据末尾。固定长度协议需要完整数据时返回业务错误；可变长度内容则使用 n 截取有效字节即可。