strings.builder扩容公式为“2×cap(b.buf)+n”,即当前容量翻倍后加上新增需求字节数,确保扩容后容量足以容纳全部新数据。

strings.Builder 的扩容公式是「当前 cap × 2 + 新增需求」
它不是固定翻倍,也不是加常量,而是先尝试双倍扩容,再确保能容纳本次写入的全部内容。比如当前底层数组 cap 是 64,你要 WriteString("hello")(5 字节),它不会扩到 128;但如果你要写入 100 字节,而当前 cap 只有 64,就会扩到 max(64×2, 64+100) = 128 —— 因为 128 ≥ 164?不,128 make([]byte, 164),Go runtime 通常按需分配,不强制对齐)。
这个逻辑和 slice 的扩容行为一致,但注意:strings.Builder 不暴露底层数组,你无法像 append() 那样干预中间状态,只能靠 Grow() 提前提示。
Grow(n) 不是分配 n 字节,而是「确保至少有 n 字节可用空间」
Grow() 的参数 n 表示“我接下来要写入的内容总长至少需要 n 字节”,它会检查当前剩余容量(cap - len),若不足,则触发扩容。它不保证最终 cap 就是 n,可能更大。
- 如果当前
cap是 0,b.Grow(100)会直接分配一个cap >= 100的底层数组(通常是 100 或略高) - 如果当前
cap是 128、len是 80,剩余 48 字节,b.Grow(100)就会扩容,因为 48 - 多次调用
Grow()不会叠加效果,只以最大一次为准;重复调用小值无副作用,但无意义
不预估容量时,第一次 WriteString 就可能触发扩容
零值 strings.Builder{} 的初始 cap 是 0,第一次 WriteString(s) 会分配 len(s) 大小的底层数组 —— 看似合理,但若后续还要追加,马上面临第二次扩容。例如拼接 10 段各 100 字节的字符串,不 Grow(),大概率经历:0→100→200→400→800… 至少 4 次分配。
实测在总长 64KB 场景下,预设 Cap: 65536 比默认构造快约 15%,GC 压力明显更低。
常见误操作:
- 在循环里每次新建
Builder却不Grow()→ 白费扩容开销 - 用
Reset()复用大容量实例去拼很小的字符串 → 底层数组滞留、浪费内存、拖慢 GC - 以为
Grow(1024)后就能安全写 1024 字节,却忘了已写入部分也占容量 → 实际可用空间是cap - len,不是Grow()的参数
Cap() 和 Len() 的区别直接影响扩容判断
b.Len() 返回当前已写入字节数(即字符串长度),b.Cap() 返回底层数组总容量。两者差值才是剩余空间。扩容是否发生,只取决于 Cap() - Len() 。
容易被忽略的一点:Cap() 包含已写入内容占用的空间,不是“还能写多少”。所以不能用 b.Cap() == 0 判断是否为空 —— 应该用 b.Len() == 0。
调试时可这样观察:
var b strings.Builder
fmt.Printf("Len: %d, Cap: %d\n", b.Len(), b.Cap()) // Len: 0, Cap: 0
b.WriteString("hi")
fmt.Printf("Len: %d, Cap: %d\n", b.Len(), b.Cap()) // Len: 2, Cap: 2 或 32(取决于 runtime 分配策略)
不同 Go 版本或负载下,初始分配行为可能略有浮动,但扩容逻辑稳定。真正影响性能的,从来不是“第几次扩容”,而是“有没有让底层数组一步到位”。











