Rust / 系统课时
使用缓冲读取
使用缓冲读取
直接对异步流反复做小块读取,会让业务代码频繁处理边界与分隔符。BufReader 在底层流之上维护缓冲区,让 read_line、read_until 等接口按协议边界取数据,同时保留已经预读但尚未消费的字节。
学习目标
- 使用
BufReader包装 Tokio 异步读取端,并调用read_line与read_until - 理解“已预读到缓冲区”与“底层流尚未读取”之间的状态关系
- 避免绕过缓冲器直接读取底层流造成数据顺序混乱或丢失
缓冲读取解决什么问题
BufReader<R> 包装一个实现 AsyncRead 的读取源。调用者只需要按行或按分隔符消费数据;当内部缓冲区不够时,BufReader 才继续从底层流读取。一次底层读取可能取得超过当前边界的数据,多出来的部分会留在缓冲区,供下一次读取继续使用。

这意味着“底层流当前位置”不等于“业务代码已经消费的位置”。只要 BufReader 仍持有未消费字节,就应该继续通过同一个缓冲器读取。
按行和按分隔符读取
示例使用 tokio::io::duplex 构造一对内存异步流,不依赖真实网络。在已添加 Tokio 1.x 且启用 full 特性的 Cargo 项目中可直接运行。
rust
use tokio::io::{
self, AsyncBufReadExt, AsyncReadExt, AsyncWriteExt, BufReader,
};
#[tokio::main]
async fn main() -> io::Result<()> {
let (client, mut server) = tokio::io::duplex(64);
// 写入三段数据,并关闭写端表示后续不会再有字节。
server.write_all(b"alpha\nbeta|tail").await?;
server.shutdown().await?;
let mut reader = BufReader::new(client);
let mut line = String::new();
reader.read_line(&mut line).await?;
print!("line={line}");
let mut chunk = Vec::new();
reader.read_until(b'|', &mut chunk).await?;
println!("chunk={}", String::from_utf8_lossy(&chunk));
// 继续从同一个 BufReader 读取,先消费其中已缓冲的剩余数据。
let mut tail = String::new();
reader.read_to_string(&mut tail).await?;
println!("tail={tail}");
Ok(())
}预期输出
text
line=alpha
chunk=beta|
tail=tailread_line 会把读取到的内容追加到传入的 String,遇到换行符时返回,并保留该换行符;read_until 会把字节追加到 Vec<u8>,直到包含指定分隔字节。两者返回值都是本次追加的字节数。
选择接口时注意边界
如果协议明确是 UTF-8 文本行,read_line 最直接;如果边界是单个字节,或数据不保证是 UTF-8,优先使用 read_until。重复调用前还要决定是清空目标缓冲区,还是有意继续追加。
需要取回底层流时可调用 into_inner,但尚未被消费的内部缓冲数据不会自动交还给底层流。若这些字节仍然重要,应先通过 BufReader 把它们处理完,再改变读取方式。
按自己的节奏,确认真正理解。