Go bytes.Reader 怎么读取字节游标

在 Go 里，手上已经有一段 []byte，又想像读文件一样逐段取数据时，可以用 bytes.NewReader 创建 bytes.Reader。它是只读读取器，内部维护一个当前字节位置：Read、ReadByte 会推进位置，ReadAt 按指定偏移取数据但不改变这个位置，Seek 才是显式移动游标。

先分清 bytes.Reader 的游标和长度

bytes.Reader 读取的是字节，不是字符。中文字符串转成 []byte 后，一个字符通常会占多个字节，所以 Len 和肉眼看到的字符数不能直接比较。新建 Reader 时位置为 0，Len 与输入切片长度相等；一旦读取，只有 Len 变化，Size 仍表示原始长度。

package main

import (
    "bytes"
    "fmt"
)

func main() {
    data := []byte("Go字节")
    r := bytes.NewReader(data)

    // Len 是当前位置之后的未读字节数，Size 是原始字节总数。
    fmt.Println(r.Len(), r.Size())

    buf := make([]byte, 2)
    n, err := r.Read(buf)
    // Read 会推进游标；n 表示本次真正写入 buf 的字节数。
    fmt.Printf("%q n=%d err=%v len=%d size=%d\n", buf[:n], n, err, r.Len(), r.Size())
}

顺序读取时看 Read 的 n 和 err

把 Reader 当成 io.Reader 使用即可。每次调用 Read(buf)，返回值 n 是本次有效字节数，不能直接把整个 buf 转成字符串，因为缓冲区可能比剩余内容更长。读到当前位置末尾后，再次读取会得到 n=0, err=io.EOF。

如果只需要一个字节，可以用 ReadByte；要把当前游标之后的内容一次转换成新切片，则可以使用 io.ReadAll(r)。注意它会消费剩余数据，之后 Len() 就会变成 0。

顺序读取和按偏移读取要分开

ReadAt 适合读取固定位置，例如解析一个已知偏移的头字段。它的 off 是从原始字节切片开头算起的 int64 偏移，不会改变 Read 使用的主游标；如果目标区域不足以填满缓冲区，会返回已经读取的字节数和 io.EOF。如果想让后续 Read 从新位置继续，应使用 Seek。

package main

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

func main() {
    r := bytes.NewReader([]byte("0123456789"))
    part := make([]byte, 3)

    n, err := r.ReadAt(part, 4)
    // ReadAt 从固定偏移取数据，不推进 r 的顺序游标。
    fmt.Printf("at=%q n=%d err=%v len=%d\n", part[:n], n, err, r.Len())

    pos, err := r.Seek(2, io.SeekStart)
    // Seek 才会改变后续 Read 的起点；返回值是新的绝对位置。
    fmt.Println("pos", pos, "err", err)
}

转换剩余字节或重新开始读取

如果目标是得到当前剩余区间的独立副本，可以调用 io.ReadAll(r)；如果只是想重新从原切片开头读取，Seek(0, io.SeekStart) 更直接。要复用同一个 Reader 读取另一段切片，则调用 Reset(newData)，它会把长度和游标一起换成新数据。

实际排查时先问自己三个问题：这是顺序流还是固定偏移？读取后是否还要继续从原位置读？长度单位是字节还是字符？这三个判断比盲目扩大缓冲区更重要。

常见问题

ReadAt 之后为什么 Len 没变？

这是正常行为。ReadAt 实现的是 io.ReaderAt，固定偏移读取不能修改 Reader 的顺序状态；要移动主游标请调用 Seek。

Len 和 Size 应该选哪个？

判断还能读多少用 Len，记录原始输入大小或计算绝对偏移范围用 Size。读取过程中 Size 不会因为 Read 变小。

中文内容为什么 Len 比字符数大？

Reader 面向字节切片，UTF-8 中文通常由多个字节组成。需要按字符读取时，应先使用合适的 UTF-8 解码或 rune 处理，不要把字节长度当字符长度。