strings.Builder扩容公式为cap×2+新增长度,非固定翻倍;Grow(n)确保len+n≤cap,不强制分配n字节;初始cap为0,扩容策略优先满足本次写入,更紧凑但需合理预估总长。

strings.Builder 的扩容公式是 cap × 2 + 新增长度,不是固定翻倍
很多人以为 strings.Builder 和 slice 一样只做「翻倍」扩容(即 cap * 2),其实它更保守:当当前容量不足以容纳新写入内容时,底层会调用类似 make([]byte, cap*2+needed) 的逻辑——needed 是本次 WriteString 长度,不是固定值。这意味着:第一次写入 1 字节,初始 cap 为 0,分配后 cap 变成 8;但若接着写入 100 字节,而当前 cap 只有 8,它不会只扩到 16,而是直接扩到至少 108(8×2 + 100)。
Grow(n) 不等于分配 n 字节,而是确保 len + n ≤ cap
Grow(n) 的作用是「提前预留空间」,不是强制把底层数组设为 n 字节。它检查当前 cap - len 是否 ≥ n,不够才触发扩容。常见误用是:b.Grow(1024) 后又立刻 WriteString("a"),结果发现底层数组还是 1024 —— 这没问题,但如果你后续要拼接 2KB 内容却只 Grow(1024),仍然会触发一次扩容。
- 正确估算:用
len(a)+len(b)+len(c)+...+20(留点分隔符余量)代替拍脑袋的 1024 - 不要在循环里对同一个
Builder反复Grow:它不重置已分配容量,多次调用无意义 -
Grow调用本身几乎零开销,但没预估好导致多一次扩容,性能损失远大于调用成本
为什么不用 bytes.Buffer 那套扩容逻辑?
bytes.Buffer 的扩容策略更激进(例如默认 cap=64,首次超限就扩到 128),而 strings.Builder 初始 cap=0,且扩容时优先满足「本次写入」,不预占冗余空间。这带来两个实际影响:
- 拼接总长可控的小字符串(如生成固定结构 JSON)时,
strings.Builder内存更紧凑 - 但若拼接模式极不规则(比如每次写入长度从 1B 到 1MB 波动),它的扩容次数可能略高于预设大 cap 的
bytes.Buffer - 二者都不支持「缩容」,
Reset()只清len,不释放底层数组——这点容易被忽略,尤其在长生命周期对象中反复Reset会导致内存驻留
实测扩容行为:看 cap 变化比看文档更可靠
别全信“翻倍”说法,直接打印 cap 最实在:
var b strings.Builder
fmt.Printf("init cap: %d\n", b.Cap()) // 0
b.WriteString("x")
fmt.Printf("after 'x': %d\n", b.Cap()) // 8
b.WriteString(strings.Repeat("a", 100))
fmt.Printf("after 100 'a': %d\n", b.Cap()) // 108 或 128(取决于 runtime 实现细节)
不同 Go 版本微调过扩容阈值,2026 年主流版本(1.22+)倾向「最小够用」策略,所以观察真实 cap 比背公式更有指导意义。真正关键的不是倍数,而是你是否让 Builder 在第一次写入前就知道大概要装多少东西。











