当前位置：首页 > 文章列表 > Golang > Go教程 > Go bytes.Reader 怎么读取字节游标

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

来源：17golang原创 2026-09-13 08:54:42 0浏览收藏

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

要点速览

Len() 看当前还有多少字节未读，Size() 看原始切片总长度。
顺序消费用 Read；固定偏移读取用 ReadAt，两者不要混用。
需要重新读取时用 Seek(0, io.SeekStart) 或 Reset，转换剩余数据可用 io.ReadAll。

先分清 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())
}

Go bytes.Reader 使用 Read 顺序读取字节并让游标向后移动的操作示意图 — 图1：bytes.Reader 按顺序读取字节时，游标向后移动，Len 只统计尚未读取的字节。

顺序读取时看 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)
}

Go bytes.Reader 使用 ReadAt 偏移读取并用 Seek 移动主游标的结果示意图 — 图2：ReadAt 按偏移读取时不改变主游标，Seek 则用于显式移动顺序读取位置。

方法	用途	是否改变主游标
`Read` / `ReadByte`	从当前位置顺序读取	是
`ReadAt`	从固定偏移读取	否
`Seek`	调整后续顺序读取位置	是
`Reset`	换一段数据并回到开头	重置