Go strings.Builder 生成字符串后还能继续写吗

很多人第一次把 strings.Builder 用在循环里时，会在 b.String() 之后犹豫：这个 Builder 是不是已经“封口”，下一次 WriteString 会不会改坏刚刚拿到的字符串？答案是可以继续写。String() 只读取当前累计内容，不会把 Builder 变成只读对象；真正不能做的是把已经写入内容的 Builder 按值复制，或让多个 goroutine 同时使用同一个 Builder。

安全的习惯是：Builder 始终由一个变量独占，结果字符串在需要时保存；下一轮要从空内容开始，就显式调用 Reset()，不要靠重新赋值或复制 Builder 来“复用”。

先记住结论：String 后可以继续写，但不要复制 Builder

strings.Builder 的零值可以直接使用。第一次写入后，调用 String() 得到的是当前累计字符串；随后再次写入，Builder 会把新内容追加到原来的长度之后。所以这段代码的结果是 "Go教程：生命周期"，不会因为第二次写入而 panic：

package main

import (
	"fmt"
	"strings"
)

func main() {
	var b strings.Builder
	b.WriteString("Go教程") // 先写入第一段内容
	first := b.String()    // 保存当前结果，不会锁住 Builder
	b.WriteString("：生命周期") // 从原有长度之后继续追加

	fmt.Println(first)     // 输出：Go教程
	fmt.Println(b.String()) // 输出：Go教程：生命周期
}

需要特别分开的概念是“继续写”和“复制”。文档明确要求不要复制非零 Builder。像 copy := b、把 Builder 作为结构体字段按值传递，或者把它作为值返回，都可能触发运行时的非法复制检查。若确实需要两份独立内容，先拿到字符串，再让另一份 Builder 从字符串重新开始。

String 为什么不会把已经生成的字符串改掉

可以把 Builder 想成“当前长度 + 底层字节缓冲区”。WriteString 追加时从当前长度位置开始写；如果容量不够，内部会换一块更大的缓冲区并复制旧内容。无论是否换缓冲区，之前返回的字符串长度都不会自动增长。

这也是为什么 first 仍然是 Go教程，而再次调用 b.String() 才会拿到更长的内容。字符串本身没有可供调用方修改的写入方法，Builder 的后续追加只影响 Builder 当前的累计长度。

这里不要把 String() 理解成一次“最终提交”。它只是一个读取方法；真正决定结果边界的是你把返回值保存在哪里、何时把它交给调用方。若结果要跨越后续的复用周期保存，就保存返回的字符串；若只是马上写到响应或日志，也可以直接使用。

组合 Reset、Grow 与写入方法

在批量生成标题、日志片段或 SQL 条件时，常见模式是同一个 Builder 多轮使用。每轮开始先 Reset()，然后按大致的文本规模调用 Grow，最后用 String() 取得本轮结果。Grow(n) 保证至少还能写入 n 个字节，但它不等于“把容量设置为 n”，也不等于字符串字符数。

func buildLabels(labels []string) []string {
	var b strings.Builder
	results := make([]string, 0, len(labels))

	for _, label := range labels {
		b.Reset()       // 清空上一轮内容，但保留可复用的 Builder 状态
		b.Grow(len(label) + len("label=")) // n 表示额外字节空间
		b.WriteString("label=") // 先写固定前缀
		b.WriteString(label)     // 再写本轮输入
		results = append(results, b.String()) // 保存本轮字符串结果
	}
	return results
}

示例中 results 保存了每一轮的字符串，而不是保存 Builder。这个边界很重要：如果把 Builder 指针放进结果切片，后续 Reset() 和写入就会让所有元素指向同一个可变构建对象，读者看到的内容会和预期不同。

一段完整写法：把 Builder 的生命周期留在单个函数里

如果构建逻辑不需要跨函数保存，最稳妥的做法是让 Builder 只在一个函数中创建和使用，函数返回字符串，而不是返回 Builder。这样既不会误复制非零对象，也不会把内部缓冲区的生命周期暴露给调用方。

func formatEndpoint(host, path string) string {
	var b strings.Builder
	b.WriteString("https://") // 固定协议部分
	b.WriteString(host)       // 写入主机名
	if !strings.HasPrefix(path, "/") {
		b.WriteByte('/') // 统一路径分隔符
	}
	b.WriteString(path) // 写入路径并返回最终字符串
	return b.String()
}

如果这个函数会被并发调用，局部变量 b 也会随每次调用独立创建，因此不会出现共享 Builder 的数据竞争。相反，把一个 Builder 放在全局变量、共享结构体或池中时，必须额外设计独占关系；单纯加一个“调用完成后再读”的约定，不能替代同步。

常见问题

调用 String 后还需要重新声明 Builder 吗？

不需要。只要还要在原内容后追加，就继续使用同一个 Builder；只有想从空内容重新构建时才调用 Reset()。

String 返回值会随着 Builder 后续写入自动变长吗？

不会。返回值的长度在调用时确定，后续追加不会改变已经保存的字符串；需要最新内容时重新调用 String()。

为什么不能把 strings.Builder 作为值传给函数？

非零 Builder 不能按值复制。把它作为参数传值可能复制内部状态，应该传 *strings.Builder，或者直接在函数内部创建 Builder 并返回字符串。

相关 API 可以在 Go 标准库的 strings.Builder 文档中查看；实现细节可对照 Go 官方的 builder.go 源码。记住“Builder 负责构建，字符串负责保存结果”，String 后继续写就不再是一个容易混淆的生命周期问题。