Go bytes.Buffer AvailableBuffer 怎么安全复用：切片容量与下次写入边界

做批量日志拼接时，如果每一行都先把数字转成临时字符串，再交给 bytes.Buffer，代码虽然直观，却会把格式化和缓冲区扩容拆成两段。Go 1.21 起可以用 AvailableBuffer 拿到缓冲区当前可用容量，直接追加内容，再把结果紧接着写回同一个 Buffer。

AvailableBuffer 返回的是长度为 0、容量等于当前可用空间的切片；它只适合追加后立刻传给同一个 Buffer 的 Write，不要跨越下一次写入长期保存。

先看清 AvailableBuffer 到底返回了什么

bytes.Buffer 同时维护已写入长度和底层切片容量。Len() 是当前可读数据的长度，Cap() 是底层空间总容量，而 Available() 表示还能在不扩容的情况下使用多少空间。AvailableBuffer() 返回一个长度为 0 的切片，所以刚拿到它时读取切片长度会得到 0，但追加时仍然可以使用它的容量。

var buf bytes.Buffer
buf.Grow(32)

scratch := buf.AvailableBuffer()
fmt.Println(len(scratch), cap(scratch)) // 0 32
scratch = append(scratch, "id="...)
buf.Write(scratch)

这里的 scratch 不是 Buffer 的“已写内容”，而是本轮的 追加切片。它只是给下一次写入准备的工作切片；只有调用 Write 后，追加进去的字节才进入 Buffer 的数据范围。

一个循环里如何把格式化结果直接写回 Buffer

线上日志通常是一行一行追加，数字字段尤其容易制造临时字符串。下面的循环把 strconv.AppendInt、append 和 Buffer.Write 连成一条短路径：每一轮先取当前容量，再追加本轮内容，最后马上写回。

package main

import (
    "bytes"
    "fmt"
    "strconv"
)

func buildLog(ids []int64) string {
    var buf bytes.Buffer
    buf.Grow(len(ids) * 12)

    for _, id := range ids {
        b := buf.AvailableBuffer()
        b = append(b, "id="...)
        b = strconv.AppendInt(b, id, 10)
        b = append(b, '\n')
        _, _ = buf.Write(b)
    }
    return buf.String()
}

func main() {
    fmt.Print(buildLog([]int64{17, 42, 108}))
}

每次循环的 b 都是长度从 0 开始的临时切片，AppendInt 会把数字追加到它的尾部。Write 完成后，buf.Len() 增加本轮实际追加的长度，下一轮重新调用 AvailableBuffer，避免拿上一轮的切片猜测新容量。

长度、容量和下一次写入别混在一起

这段代码最容易被误读的地方，是把 cap(b) 当成了本轮输出长度。实际上，cap(b) 是剩余空间，len(b) 才是本轮应该传给 Write 的数据长度。追加操作可能因为剩余空间不足而分配新的底层数组，但这不改变“追加后立即写入”的使用方式。

b := buf.AvailableBuffer()
b = append(b, "id="...)
b = strconv.AppendInt(b, id, 10)

fmt.Println("本轮输出长度:", len(b))
fmt.Println("仍可追加容量:", cap(b)-len(b))
_, _ = buf.Write(b)

如果想观察复用效果，可以在写入前打印 buf.Available()，写入后再打印 buf.Len()。前者描述 Buffer 还能提供多少空间，后者描述已进入 Buffer 的数据量，两个数字服务于不同判断。

哪些写法会越过有效期边界

官方文档明确说明，AvailableBuffer 返回的切片只在 Buffer 的下一次写操作前有效。把它塞进结构体、交给另一个 goroutine，或者在 buf.Write 后继续修改，都不适合作为稳定的数据引用。

// 不要这样保存工作切片
scratch := buf.AvailableBuffer()
pending = append(pending, scratch)

// 也不要在 Write 后把 scratch 当作 Buffer.Bytes() 的长期别名
_, _ = buf.Write(scratch)

需要跨函数或跨协程传递时，先复制成独立切片，例如 stable := append([]byte(nil), b...)，再把 stable 交给其他代码。这样做会产生一次复制，但边界清楚，生命周期也不依赖 Buffer 的后续修改。

落地前的三项检查

• 确认项目使用的 Go 版本包含 AvailableBuffer；官方 bytes 文档标注该方法 added in go1.21.0。
• 确认每轮都是“取切片—追加—同一个 Buffer.Write”，中间不要插入其他写操作。
• 如果要保留结果，保留 buf.Bytes() 的复制品或独立切片，不要保留工作切片本身。

把 AvailableBuffer 当作一次紧邻写入的工作区，才是它最稳妥的用法。它适合减少格式化过程中的中间分配，却不会改变切片别名和 Buffer 生命周期的基本规则。

相关问题

AvailableBuffer 返回的切片为什么长度是 0？

因为它表示“准备追加的空切片”，当前可用空间通过容量表达；追加后长度才反映本轮数据。

可以把 AvailableBuffer 当成 Buffer.Bytes 使用吗？

不可以。Bytes() 表示当前未读内容，而 AvailableBuffer() 是给下一次写入准备的空工作区。

没有预先 Grow 还能使用吗？

可以，Buffer 会按自身规则扩容；预先 Grow 只是让容量意图更明确，是否减少分配仍取决于实际数据量。