当前位置：首页 > 文章列表 > Golang > Go教程 > Go bytes.Buffer AvailableBuffer 怎么安全复用：切片容量与下次写入边界

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

来源：17golang原创 2026-08-27 18:41:31 0浏览收藏

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

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

实践要点

用 b := buf.AvailableBuffer()，再执行 strconv.AppendInt 或 append。
追加后的切片长度才是本次要写入的字节数，容量不是输出长度。
buf.Write(b) 必须紧跟在追加之后，写入后旧切片不再适合作为稳定引用。

先看清 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 的数据范围。

AvailableBuffer 从 buf.Available 到追加切片再到 Buffer.Write 的容量与写入路径

一个循环里如何把格式化结果直接写回 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，避免拿上一轮的切片猜测新容量。

循环中 AvailableBuffer、strconv.AppendInt、Buffer.Write 和 buf.Len 的真实调用链

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

这段代码最容易被误读的地方，是把 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 的后续修改。