Go bufio.Writer.AvailableBuffer 返回切片的有效期怎么判断

Go 的 bufio.Writer.AvailableBuffer 返回的是一段“立即写入窗口”，不是可以长期持有的普通字节切片。正确用法是拿到切片、用 append 填入内容，然后紧接着传给同一个 Writer 的 Write；一旦 Writer 发生下一次写操作，之前返回的切片就不应再继续使用。

官方地址：https://pkg.go.dev/bufio#Writer.AvailableBuffer

这个方法在 Go 1.18 加入。官方文档明确说明：返回切片的长度为 0，容量等于当前 Writer 的可用空间；它只保证在 Writer 的下一次写操作之前有效。

AvailableBuffer 到底返回了什么

AvailableBuffer 返回空切片，因此通常要先用 append 或 strconv.AppendInt 写入内容。它的容量来自 Writer.Available()，并不代表这次调用为你创建了一个可以脱离 Writer 的独立缓冲区。

为什么必须 append 后立即 Write

最稳妥的模式是把“生成本条记录”和“提交本条记录”放在同一个小范围内。下面的示例没有把切片保存到队列，也没有在下一次 Writer 操作后再次读它：

package main

import (
	"bufio"
	"fmt"
	"os"
	"strconv"
)

func writeNumber(w *bufio.Writer, n int64) error {
	// AvailableBuffer 返回长度为 0 的临时写入窗口，只在下一次写操作前使用。
	b := w.AvailableBuffer()
	// append 把数字追加到窗口；内容超出容量时会产生新的切片，仍需立即 Write。
	b = strconv.AppendInt(b, n, 10)
	b = append(b, '\n')
	// 立即把当前记录交给同一个 Writer，避免跨越后续写操作继续使用 b。
	_, err := w.Write(b)
	return err
}

func main() {
	w := bufio.NewWriter(os.Stdout)
	if err := writeNumber(w, 42); err != nil {
		// Write 失败时停止继续提交，避免把错误留到更晚才发现。
		fmt.Fprintln(os.Stderr, err)
		return
	}
	// Flush 负责把 Writer 内部仍未输出的数据交给底层目标。
	if err := w.Flush(); err != nil {
		fmt.Fprintln(os.Stderr, err)
	}
}

这里的关键不是“永远不能使用切片变量”，而是不能让它跨过 Writer 的下一次写操作。函数返回前完成 Write，生命周期就被限制在一个清晰的同步区间里。

哪些操作会让旧切片失效

判断标准可以简化为：只要同一个 bufio.Writer 继续写入，旧的 AvailableBuffer 就不能再被当作稳定数据使用。Write、WriteByte、WriteRune、WriteString 都属于需要重新取窗口的操作；Flush 也不应与旧切片交错使用。

因此下面这些做法都不稳妥：

• 把切片放进 channel，让另一个 goroutine 稍后写入或读取；
• 先保存切片，随后调用同一个 Writer 的 WriteString，再回来修改旧切片；
• 把切片作为结构体字段长期缓存，期待下一轮继续复用。

如果确实需要异步处理或长期保存，请在交给异步边界前复制数据，例如使用 bytes.Clone(b)；这已经不再是 AvailableBuffer 的零额外复制使用方式。

容量不足和错误应该怎么处理

AvailableBuffer 的容量只是当前剩余空间。记录长度不固定时，append 可能超出它的容量并返回另一片底层存储，这并不会改变“需要立即 Write”的规则。不要用 cap(b) 当成业务数据上限，也不要假设一次 Write 就代表数据已经到达最终文件或网络。

func writeLine(w *bufio.Writer, text string) error {
	// 先取当前窗口，再追加本行内容和换行符。
	b := w.AvailableBuffer()
	b = append(b, text...)
	b = append(b, '\n')
	// Write 返回短写或底层错误时，立即把错误交给调用方。
	if _, err := w.Write(b); err != nil {
		return err
	}
	return nil
}

最后调用 Flush 时也必须检查错误，因为缓冲 Writer 可能把底层写入延迟到 Flush 才真正发生。实际项目中可以把每条记录的 Write 错误和最终 Flush 错误分别记录，定位会比只检查其中一个更清楚。

常见问题

AvailableBuffer 和 Available 有什么区别？ Available 只返回剩余容量数值；AvailableBuffer 返回长度为 0、带有这段容量的切片，适合直接 append 后 Write。

调用 Flush 后还能继续用旧切片吗？ 不建议。Flush 是 Writer 的写入操作边界；需要新内容时重新调用 AvailableBuffer。

它适合所有大字符串写入吗？ 不一定。它适合能在一次同步写入窗口内构造的短记录；异步队列、长期缓存和需要独立所有权的数据，应明确复制或采用独立缓冲区。

记住一句话：AvailableBuffer 只借给你 Writer 当前剩余空间，append 完就立即 Write；下一次写操作之后，重新取一段新的窗口。