Golangbytes包技巧：Buffer与Reader详解

积累知识，胜过积蓄金银！毕竟在Golang开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Golang bytes包使用技巧：Buffer与Reader详解》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

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 零分配，但要求输入切片稳定。

• 已知数据大小时，预分配 Buffer：

  buf := bytes.Buffer{}
  buf.Grow(1024) // 预留空间，减少扩容次数
  

• 从网络或文件读取小块数据时，别用 bytes.Buffer 当中转——直接写入目标结构体或使用 io.Copy(dst, src) 更高效
• buf.String() 每次都新建字符串（底层 runtime.string() 拷贝），高并发日志拼接建议用 fmt.Fprintf(&buf, ...) 累积，最后一次性转字符串

到这里，我们也就讲完了《Golangbytes包技巧：Buffer与Reader详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！