Go bytes.Reader Len 和 Size 返回值为什么不同

在 Go 里用 bytes.NewReader 包装一段内存数据时，Len() 和 Size() 都像是在问“有多少字节”，但它们观察的不是同一个边界：Len() 是当前游标后还没读过的字节数，Size() 是创建 Reader 时底层字节切片的原始长度。读过一部分以后，前者会变小，后者通常不变。

读取循环要判断“还剩多少”就用 Len()；要记录原始载荷大小、计算 ReadAt 的范围或做总量统计就用 Size()。不要因为两个方法都返回长度，就把它们互换。

先把 Len 和 Size 放到两条边界上

bytes.Reader 是一个只读、可定位的字节切片 Reader。可以把它想成一条长度为 6 的字节带：Size() 看整条带子的长度，Len() 看游标当前位置之后还剩多少。刚创建时两者相等；游标前移后，两者自然分开。

一次 Read 就能看出两个值为什么不同

下面的例子故意先读取两个字节，再同时打印两个长度。代码中的中文注释说明了游标变化和返回值选择，示例不需要依赖文件或网络输入。

package main

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

func main() {
    r := bytes.NewReader([]byte("abcdef"))
    fmt.Println(r.Len(), r.Size()) // 初始状态：未读长度和原始长度都是 6

    buf := make([]byte, 2)
    n, err := io.ReadFull(r, buf) // 读取两个字节，Reader 的当前位置向前移动
    if err != nil {
        panic(err) // 示例只接受完整读取，生产代码应按业务处理 EOF
    }

    fmt.Println(string(buf), n)
    fmt.Println(r.Len(), r.Size()) // 结果为 4 和 6：剩余量变了，总量没有变
}

运行时第二组长度是 4 6。这里的 4 适合用来决定读取循环是否还有工作，6 适合写入日志、记录原始报文长度或计算一个基于原始位置的范围。若数据包含中文，仍然按 UTF-8 编码后的字节数计算，不是按汉字个数计算。

ReadAt、Seek 和 Reset 分别改变了什么

排查“长度突然不对”时，先看最近调用的是哪一类方法。ReadAt 从指定偏移读取，不改变 Reader 的当前游标，所以它不会让 Len() 变小；Seek 会改变游标，随后 Len() 会按新位置重新计算；Reset 用新的字节切片重置 Reader，Size() 也会跟着新切片变化。

// r 已经从 "abcdef" 读过两个字节，此时当前位置在 2。
var peek [2]byte
n, err := r.ReadAt(peek[:], 1) // 从偏移 1 读取，不移动 r 的当前位置
if err != nil && err != io.EOF {
    panic(err) // ReadAt 可能返回 n>0 与 io.EOF，按 n 判断有效数据
}
fmt.Println(n, r.Len(), r.Size()) // Len 仍由当前位置决定，Size 仍是原始长度

_, err = r.Seek(0, io.SeekEnd) // 定位到末尾，未读区域变成 0
if err != nil {
    panic(err) // Seek 失败时不要继续使用新的位置假设
}
fmt.Println(r.Len(), r.Size()) // 0 和 6

r.Reset([]byte("xy")) // 只有 Reset 换掉了底层数据边界
fmt.Println(r.Len(), r.Size()) // 2 和 2

另一个容易忽略的点是类型：Len() 返回 int，Size() 返回 int64。如果总长度要传给只接受 int 的切片索引或内存分配参数，应先确认数据不会超出平台 int 的范围，再显式转换；不要在表达式里混用后依赖隐式转换，因为 Go 不会替你完成整数类型转换。

按业务目标选择方法，避免把“剩余量”当“总量”

• 解析循环、判断是否还要继续读取：使用 Len()，或者直接根据读取返回的 n 和 err 判断。
• 记录原始请求体、文件片段或消息载荷大小：使用 Size()，它不受已经读取多少影响。
• 随机读取固定偏移：使用 ReadAt，不要先用 Len() 推断整个底层切片的大小。
• 复用 Reader 读取另一段数据：调用 Reset 后重新获取 Len() 和 Size()，不要保留旧的总长度。

最后记住一个边界：Size() 代表底层字节切片的长度，不是它的容量；Len() 也不是“已经读了多少”。把这两个概念和当前游标分开，绝大多数 bytes.Reader 长度问题都能在调用点解决。

相关问题

bytes.Reader 的 Len 会因为 ReadAt 变小吗？

不会。ReadAt 使用显式偏移读取，不改变 Reader 的当前游标；Len() 仍然按照调用前的当前位置计算。

bytes.Reader 的 Size 会因为 Seek 到末尾变成 0 吗？

不会。Seek 只改变当前位置，所以到末尾后通常是 Len() == 0，而 Size() 仍保持原始长度；只有 Reset 换入新切片后，Size 才会更新。

官方定义可参考 bytes.Reader.Len 与 bytes.Reader.Size。