Python BufferedReader.peek：只预览一个字节，为什么拿到四个，底层位置也已经前进
检查文件头时，peek(1)看起来像“先看一个字节而不读取”。运行后却拿到一整块内容；更奇怪的是，包装器tell仍为零，底层对象tell已经到了四。这两个结果能够同时成立，因为预览接口面对的是缓冲流，底层填充缓冲区仍可能真正读取数据。
下面的程序只包装内存中的BytesIO，不需要真实文件，已在CPython 3.12.14执行。保存为demo.py，用python3 demo.py运行。为了让差异可见，缓冲大小固定为四；显示的具体预取数量是本次环境的观察，不应写成所有底层流都必须返回四字节的接口保证。
AI模型生成概念图：固定入口标记前方的托盘已经装入多块数据，用于比喻预取进入缓冲而逻辑读取位置未推进；不是内存结构实测图。
把包装器与底层位置同时打印
第一次peek后，程序检查返回值以A开始，并确认reader.tell仍为零。raw.tell只用于观察底层预取，没有再调用raw.read来抢走数据。随后用更大的请求、一次真正read以及有界预览，对照哪些动作会推进逻辑位置。
完整可运行程序
import io
raw = io.BytesIO(b"ABCDEFGH")
with io.BufferedReader(raw, buffer_size=4) as reader:
seen = reader.peek(1)
assert seen.startswith(b"A")
assert reader.tell() == 0
print("peek(1):", seen)
print("positions after peek:", reader.tell(), raw.tell())
large_request = reader.peek(99)
assert large_request == seen
print("peek(99):", large_request)
assert reader.read(1) == b"A"
print("position after read(1):", reader.tell())
prefix = reader.peek(2)[:2]
assert prefix == b"BC"
assert reader.tell() == 1
print("bounded preview:", prefix)
remaining = reader.read()
assert remaining == b"BCDEFGH"
print("remaining:", remaining)
assert reader.peek(1) == b""
print("peek at EOF:", reader.peek(1))
assert raw.closed本次实际输出（展示内容，不是待执行程序）
peek(1): b'ABCD' positions after peek: 0 4 peek(99): b'ABCD' position after read(1): 1 bounded preview: b'BC' remaining: b'BCDEFGH' peek at EOF: b''
size不是固定返回长度承诺
本次peek(1)返回ABCD，peek(99)仍返回ABCD。前者比请求多，后者比请求少。因此把len(peek(n)) == n作为通用判断，或者把返回短于n直接当成文件不足n字节，都不成立。此刻源数据里实际上还有EFGH。
peek最多为这次调用执行一次底层读取，不负责反复读到指定数量。需要固定长度的数据时，应采用明确的消费与不足处理流程；预览只适合在目前可见的数据上做判断，不应被误当成完整报文获取器。
不推进的是哪个位置
positions after peek输出0 4。包装器已经把四个字节收入内部缓冲，因此底层位置前进；对调用reader的用户而言，一个字节还没有消费。真正执行read(1)之后，包装器位置才变成1。
接着peek(2)[:2]只保留BC作为展示片段，reader.tell仍为1；最后read返回BCDEFGH，证明预览过的BC仍可正常消费。这里的切片只限制拿去查看的长度，不会要求底层再读，也不会移动读取位置。
不要绕过包装器继续读取底层
如果在上述位置直接调用raw.read，就可能从底层的第四字节之后开始，跳过reader仍保管的数据。之后再回到reader，两条读取路径会互相扰乱。包装完成后应让一个明确入口拥有读取权，不要根据raw.tell反推用户已经处理了多少内容。
EOF处返回空字节在本例这个有限、阻塞式内存输入里很清楚。非阻塞流还涉及暂时没有数据与结束的区别，不能把这里的EOF判断原样套给所有流。退出with还会关闭包装器拥有的底层对象，最后一条断言把这个生命周期一起核对。
参考资料
资料核验日期：2026年10月2日。输出来自本文固定输入的本地实跑。
