bytes.Buffer 是可读写的字节缓冲区,同时实现 io.Reader 和 io.Writer 接口,支持边写边读、重复读和修改;底层用 []byte 自动扩容但不自动清空,需用 Reset() 安全复用。

bytes.Buffer 是可读写的字节缓冲区,不是只读容器
很多人误以为 bytes.Buffer 只是用来“收集”字节写入后一次性读取,其实它同时实现了 io.Reader 和 io.Writer 接口,能边写边读、重复读、甚至修改内部字节切片。
- 底层用
[]byte实现,自动扩容,但不会自动清空;Reset()才是安全复用方式,而不是buf = bytes.Buffer{}重新声明 - 调用
buf.String()或buf.Bytes()返回的是底层切片的拷贝(String())或引用(Bytes()),后者修改会影响后续读写,要小心 - 如果需要多次读取同一份数据,别依赖反复调用
buf.Bytes()——bytes.Buffer不重置读位置,得用buf.Reset()+ 重新写入,或改用bytes.NewReader(buf.Bytes())
bytes.NewReader 适合一次性只读场景,且不管理内存
bytes.NewReader 返回一个 *bytes.Reader,它把输入的 []byte 封装成 io.Reader,但不做拷贝,也不增长——你传进去的切片被直接持有。
- 适用于已知大小、只读、生命周期可控的场景,比如测试中模拟 HTTP 响应体:
resp := httptest.NewRecorder() resp.Body = ioutil.NopCloser(bytes.NewReader([]byte(`{"ok":true}`))) - 传入的切片若后续被修改(比如原变量重赋值、底层数组被其他代码覆盖),
*bytes.Reader的行为就不可预测 - 它不支持
io.Seeker的全部操作:虽然实现了Seek(),但只能向前或向后跳转,不能基于当前偏移做相对寻址(如Seek(0, io.SeekCurrent)不返回当前位置)
Buffer 写入后立即读取需注意读位置偏移
bytes.Buffer 的读写共享同一个游标(off 字段)。写完不重置,直接读会得到空结果。
- 常见错误:
var buf bytes.Buffer buf.WriteString("hello") data, _ := io.ReadAll(&buf) // data == []byte{}, 因为读位置在末尾 - 正确做法是用
buf.Reset()清空并重用,或用buf.Bytes()获取全部内容再构造新 Reader:var buf bytes.Buffer buf.WriteString("hello") data := buf.Bytes() // 或 buf.String() reader := bytes.NewReader(data) - 如果必须在 Buffer 上连续读写(如协议解析),用
buf.Next(n)、buf.ReadByte()或io.ReadFull(&buf, dst),它们会自动推进读位置
性能关键点:避免无谓拷贝和频繁分配
高频字节处理中,bytes.Buffer 的默认初始容量是 0,首次写入会触发一次分配;而 bytes.NewReader 零分配,但要求输入切片稳定。
立即学习“go语言免费学习笔记(深入)”;
- 已知数据大小时,预分配 Buffer:
buf := bytes.Buffer{} buf.Grow(1024) // 预留空间,减少扩容次数 - 从网络或文件读取小块数据时,别用
bytes.Buffer当中转——直接写入目标结构体或使用io.Copy(dst, src)更高效 -
buf.String()每次都新建字符串(底层runtime.string()拷贝),高并发日志拼接建议用fmt.Fprintf(&buf, ...)累积,最后一次性转字符串










