Go bytes.Reader.Size 怎样判断剩余数据长度

如果你把 bytes.Reader 当成“当前还剩多少字节”的计数器，最容易看错的就是 Size()。它返回的是底层字节切片的原始长度；真正表示顺序读取还剩多少数据的是 Len()。因此，进度计算通常写成“总量用 Size，已读量用 Size - Len”。

本文只讨论 bytes.Reader.Size、Len、Read、ReadAt 和 Reset 的长度语义。官方文档地址：https://pkg.go.dev/bytes#Reader.Size

Size 和 Len 到底分别表示什么

bytes.NewReader 从一段 []byte 创建只读 Reader。Size() 返回这段底层切片的原始字节数，结果不会因为普通读取、Seek 或 ReadAt 改变，只有调用 Reset 换入新切片时才会重新建立长度基线。

Len() 则关注顺序读取视角下的未读部分。刚创建 Reader 时，Size() 与 Len() 相等；每次成功的 Read 推进读取位置，Len() 变小，而 Size() 保持原值。

用 Read 观察未读长度变化

下面的例子只做状态观察：先读取 3 个字节，再分别打印 Size、Len 和已经读取的字节数。代码中的注释说明了每个指标对应的语义。

package main

import (
    "bytes"
    "fmt"
)

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

    // Read 推进顺序读取位置，但不会改变 Size 的原始长度。
    n, err := r.Read(buf)
    if err != nil {
        // 这里的输入足够长；生产代码仍应保留错误处理。
        panic(err)
    }

    // Size 是总量，Len 是顺序读取视角下的剩余量。
    total := r.Size()
    remaining := r.Len()
    consumed := total - int64(remaining)

    fmt.Printf("读到=%q\n", buf[:n])
    fmt.Printf("总量=%d，剩余=%d，已读=%d\n", total, remaining, consumed)
}

这段关系可以概括为：

进度展示应该用哪个值

如果页面要展示“已处理 3 / 6 字节”，总量就使用 Size()，当前剩余量使用 Len()。不要把 Len() 当成总量，也不要用一次 Read 返回的 n 直接当作整个任务的进度。

func progress(r *bytes.Reader) (read, total int64) {
    // Size 保持原始总量；Len 只表示当前还未顺序读取的部分。
    total = r.Size()
    read = total - int64(r.Len())
    return read, total
}

这个公式适合描述顺序 Read 的消费进度。如果业务混用 Seek 改变位置，公式表达的是“当前位置相对起点的偏移”，而不是已经真正处理过的业务字节数；如果使用 ReadAt，还需要另行维护业务进度。

Read、ReadAt 和 Reset 的位置边界

Read 会推进 Reader 的顺序读取位置，因而影响 Len()。ReadAt 按指定偏移读取，不改变顺序读取位置；但它读取的范围仍受 Size() 代表的原始数据范围约束。Reset 则把 Reader 改为从新的字节切片读取，Size() 和 Len() 都以新输入重新计算。

package main

import (
    "bytes"
    "fmt"
)

func main() {
    r := bytes.NewReader([]byte("abcdef"))
    scratch := make([]byte, 2)

    // ReadAt 使用独立偏移，不消费顺序读取位置。
    if _, err := r.ReadAt(scratch, 4); err != nil {
        panic(err)
    }
    fmt.Printf("ReadAt 后 Len=%d，Size=%d\n", r.Len(), r.Size())

    // Reset 换入新数据，Size 和 Len 都以新切片为基线。
    r.Reset([]byte("xy"))
    fmt.Printf("Reset 后 Len=%d，Size=%d\n", r.Len(), r.Size())
}

所以，判断“还有多少顺序数据”时看 Len；判断“这次 Reader 初始化时总共有多少字节”时看 Size；判断某个固定偏移区间能否被 ReadAt 访问时，也应以 Size 作为总范围参考。

常见误区

• 把 Size 当成剩余量：读取过数据后 Size 仍可能保持 6，剩余量要看 Len。
• 把 Len 当成原始总量：Len 会随着顺序 Read 变化，不适合做固定总量。
• 把 ReadAt 算进顺序进度：ReadAt 不推进普通 Read 的位置，混用时应分开统计。
• 忽略 Reset：Reset 后原来的总量不再适用于新数据，必须重新读取 Size。

小结

bytes.Reader.Size() 是原始字节切片长度，只有 Reset 会让它重新取值；Len() 是当前顺序读取位置之后的未读长度。最稳妥的使用方式是：总量保存 Size，剩余量读取 Len，顺序已读量用 Size - Len 推导，并对 ReadAt 单独理解其不推进顺序位置的特性。

相关问题

bytes.Reader.Size 返回的是容量吗？不是，它返回底层字节切片的原始长度，不是切片容量。

调用 Read 后 Size 会减少吗？不会，普通 Read 主要推进读取位置并减少 Len。

ReadAt 会让 Len 变化吗？不会，ReadAt 使用独立偏移，不改变顺序读取位置。

Reset 后还可以沿用旧的总量吗？不可以。Reset 换入新数据后，应重新读取 Size 和 Len。