Go bytes.Buffer 复用前为什么要 Reset

在循环里反复拼接日志、协议片段或响应文本时，bytes.Buffer 可以复用已经申请过的底层空间。但“复用变量”不等于“自动清空内容”：如果下一轮直接 Write，新内容会接在旧内容后面。正确的起点通常是先调用 Reset。

官方资料：https://pkg.go.dev/bytes#Buffer.Reset

复用不是自动清空

一个常见场景是循环构造多条文本。下面的代码只声明一次 Buffer，却连续写入两条记录：

package main

import (
	"bytes"
	"fmt"
)

func main() {
	var buf bytes.Buffer // 零值 Buffer 可以直接使用
	for _, name := range []string{"Go", "Rust"} {
		fmt.Fprintf(&buf, "name=%s", name) // 本轮内容追加到当前 unread 区域
		fmt.Println(buf.String())
	}
}

第二次输出会带上第一次的内容，因为 Write 的语义是追加，而不是覆盖。把 buf.Reset() 放在下一轮写入之前，才能让每一轮从长度 0 开始；它不会把变量重新分配成另一个 Buffer。

Reset 做了什么：长度归零，容量保留

Go 官方文档对 Reset 的定义很直接：它把 Buffer 置为空，但保留底层存储供未来写入使用，并且等价于 Truncate(0)。因此它解决的是“旧内容还在”的语义问题，同时减少同类写入反复申请空间的机会。

package main

import (
	"bytes"
	"fmt"
)

func main() {
	var buf bytes.Buffer
	buf.Grow(64) // 预留相近大小的工作空间
	buf.WriteString("first payload")
	capBefore := buf.Cap()

	buf.Reset() // 清空 unread 长度，但保留底层容量
	buf.WriteString("second")
	fmt.Println(buf.Len(), capBefore == buf.Cap(), buf.String())
}

这里第二次 String() 只得到 second。不过，“容量保留”不是无限制的内存承诺：如果某次输入异常变大，复用它可能让一个短生命周期对象继续挂着很大的数组，需按业务峰值决定是否换用新 Buffer。

Bytes 是别名，不是快照

真正容易被忽略的边界在 Bytes()。官方文档说明，返回切片只在下一次 Buffer 修改前有效，并且至少会在这段时间内与 Buffer 内容共享底层存储。也就是说，拿到 view 后马上 Reset、再写入新内容，view 不能继续当作旧结果。

package main

import (
	"bytes"
	"fmt"
)

func main() {
	var buf bytes.Buffer
	buf.WriteString("old")
	view := buf.Bytes()                 // view 只是底层存储的别名
	saved := append([]byte(nil), view...) // 需要跨轮保留时复制一份

	buf.Reset()
	buf.WriteString("new")              // 这次写入可能覆盖 view 所指向的空间
	fmt.Printf("view=%q saved=%q\n", view, saved)
}

工程上可以记住一句话：只在当前 Buffer 不再变化时读取 Bytes()；要把结果交给异步任务、缓存或下一轮处理，就先复制。复制会付出一次内存成本，但换来清晰的所有权边界。

什么时候用 Reset，什么时候直接新建

如果只是一次性构造返回值，函数内声明一个新的零值 Buffer 往往最容易读懂；如果是在稳定循环中处理相似大小的数据，Reset 才体现出复用价值。选择标准不是“Reset 一定更快”，而是数据生命周期和容量变化是否可控。

常见问题

Reset 会释放 bytes.Buffer 的内存吗？

不会。它清空可读内容并保留底层存储，后续写入可以继续使用这块空间。若需要主动摆脱一次异常大的容量，应让旧 Buffer 脱离引用并创建新的 Buffer。

Reset 和 Truncate(0) 有什么区别？

对 Buffer 的清空语义没有区别，官方文档明确说明 Reset 等价于 Truncate(0)。日常表达“开始下一轮”时使用 Reset 更直观。

为什么拿到 Bytes 后还要复制？

因为返回值与底层存储共享空间，下一次读写、Reset 或 Truncate 都可能让它失效或内容改变。跨越 Buffer 生命周期时，用 append([]byte(nil), buf.Bytes()...) 建立独立副本。

因此，Go 中复用 bytes.Buffer 的固定动作是：确认上一轮结果已经消费，调用 Reset，再写入新数据；若结果要脱离 Buffer 存活，先复制 Bytes()。这两个判断比单纯记住一个方法名更重要。