Go bytes.Reader 读取后为什么 Len 变化不对

在 Go 里用 bytes.NewReader(data) 包装一段内存数据后，最容易误判的是 Len()：它不是底层切片的固定长度，而是“当前读取位置之后还剩多少字节”。所以一次 Read 后 Len 变小是正常的；ReadAt 只读指定偏移，不移动游标，Len 不变也正常。想看原始长度，用 Size()；想回到开头，用 Seek(0, io.SeekStart) 或 Reset。

官方参考：https://pkg.go.dev/bytes#Reader

bytes.Reader 的 Len 统计的是哪一段数据

bytes.Reader 内部维护一个读取位置。Len() 返回的是底层字节切片从这个位置到末尾的剩余量，而 Size() 返回最初切片的总字节数。把两者都打印出来，误会会立刻消失：

package main

import (
    "bytes"
    "fmt"
)

func main() {
    r := bytes.NewReader([]byte("golang"))
    fmt.Println(r.Len(), r.Size()) // 初始都是 6：还没消费任何字节

    buf := make([]byte, 2)
    n, err := r.Read(buf)
    if err != nil {
        fmt.Println("读取失败:", err) // 先保留错误，避免把短读当成完整读取
        return
    }
    fmt.Println(string(buf[:n])) // go
    fmt.Println(r.Len(), r.Size()) // 4 6：剩余量变了，原始量没有变
}

这里的 Len() 变化不是数据被截断，而是游标向前移动。若业务需要展示文件或消息的原始大小，保存 Size()；若要判断还能否继续读取，使用 Len()。

Read、ReadAt 和 ReadRune 为什么让结果不同

判断 Len 是否应该变化，先看调用的方法。Read 把数据复制到目标切片并推进读取位置；ReadAt 从给定偏移读取，但遵守随机访问语义，不修改 Reader 的当前位置。ReadRune 还要注意：Len 按字节计算，不按“字符个数”计算。

package main

import (
    "bytes"
    "fmt"
)

func main() {
    r := bytes.NewReader([]byte("Go语言"))
    preview := make([]byte, 2)
    n, err := r.ReadAt(preview, 0)
    if err != nil && n == 0 {
        fmt.Println("预览失败:", err) // ReadAt 可能返回部分数据和错误
        return
    }
    fmt.Println(string(preview[:n]), r.Len()) // 预览不消耗，Len 仍为 8

    ch, size, err := r.ReadRune()
    if err != nil {
        fmt.Println("读取字符失败:", err) // EOF 等错误要和字符值一起处理
        return
    }
    fmt.Println(string(ch), size, r.Len()) // G 1 7：Len 按字节减少
}

上面的例子中，“语言”占用的字节数会大于字符数，因此不能用 Len() 推断还剩几个中文字符。需要字符数量时，应在明确编码和读取边界后另行解码。

Seek 和 Reset 怎么把读取位置恢复到预期

当同一个 Reader 被多处消费时，最稳妥的做法是显式定位，而不是猜 Len。Seek 的返回值是新的绝对位置；位置为 0 时，Len 会回到 Size。Reset 会让 Reader 改读另一段切片，同时把位置重置到开头。

package main

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

func main() {
    r := bytes.NewReader([]byte("abcdef"))
    if _, err := r.Seek(3, io.SeekStart); err != nil {
        fmt.Println("定位失败:", err) // 负位置或非法 whence 都应保留错误
        return
    }
    fmt.Println(r.Len(), r.Size()) // 3 6：当前位置是 3

    r.Reset([]byte("xy"))
    fmt.Println(r.Len(), r.Size()) // 2 2：换数据后从头开始
}

如果只是想再次读取同一批数据，Seek(0, io.SeekStart) 更直观；如果数据本身已经更换，使用 Reset 能同时表达“换源”和“归零”。

一段不容易误用的 bytes.Reader 写法

可以把“预览”和“消费”分开：预览统一用 ReadAt，正式处理才调用 Read。日志中同时记录 Size()、读取前后的 Len() 和本次返回的 n，排查长度问题时就不会把三个概念混在一起。

func consumePrefix(data []byte, want int) ([]byte, int, error) {
    r := bytes.NewReader(data)
    before := r.Len() // before 表示可消费的剩余字节数
    if want  before {
        return nil, before, fmt.Errorf("请求长度 %d 超过剩余长度 %d", want, before) // 先拒绝越界请求
    }

    out := make([]byte, want)
    n, err := io.ReadFull(r, out)
    if err != nil {
        return nil, r.Len(), err // 保留短读错误和当前剩余量
    }
    _ = r.Size() // 需要原始长度时读取 Size，不用 Len 代替
    return out[:n], r.Len(), nil
}

这段函数的返回值依次是读取内容、读取后的剩余长度和错误。若调用方还需要原始总长度，可以额外返回 int(r.Size())，不要在不同语义之间复用一个名为 length 的变量。

常见问题

为什么 bytes.Reader 读完后 Len() 是 0？

因为当前位置已经到达底层切片末尾。此时再次调用 Read 会返回 io.EOF；要重新读同一段数据，先 Seek 到开头。

ReadAt 读了数据，为什么 Len 没变化？

这是设计行为。ReadAt 使用独立偏移进行读取，不改变 Reader 的共享游标，适合预览或随机读取。

Size() 和底层切片 len 有什么区别？

在 Reader 未 Reset 时，Size 等于创建 Reader 时底层切片的长度；它表示可供 ReadAt 使用的原始范围。Len 则随当前位置变化。

Seek 到末尾后还能用 ReadAt 吗？

可以。Seek 只影响顺序读取位置，ReadAt 仍按传入的非负偏移读取；偏移超出范围时会返回 io.EOF。

记住一个判断顺序就够了：先问“我调用的是哪种读取方法”，再问“我想看剩余长度还是原始长度”。把 Len() 当作游标后的未读区，把 Size() 当作原始总量，绝大多数“Len 变化不对”的问题都能直接定位。