登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go strings.Builder Grow Builder 和 bytes.Buffer 选择哪个更合适

来源:17golang原创

时间:2026-09-11 11:57:06 494浏览 收藏

如果结果最终只需要一个 string,优先选 strings.Builder;如果结果还要作为 []byte 读取、写入、导出,或者要接入读写缓冲区语义,选 bytes.Buffer。两者的零值都可以直接使用,差别不在“谁一定更快”,而在结果类型和生命周期边界。

要点速览
  • Builder 专注于高效构造字符串,String() 是自然的终点。
  • Buffer 同时提供字节写入、读取、Bytes()WriteTo(),适合字节流。
  • Grow(n) 的 n 是字节数;Buffer.Bytes() 返回的切片会别名内部内容,不能长期保存。

先看最终结果:字符串还是字节流

strings.Builder 的定位是用一组 Write 方法高效构造字符串,标准库文档明确说明它会尽量减少内存复制,零值即可使用。它适合 HTML 片段、日志文本、SQL 片段、模板结果这类“写完后拿到 string”的场景。

bytes.Buffer 是可变大小的字节缓冲区,既能写也能读。除了 String(),还可以通过 Bytes() 取得未读字节、通过 Read 消费内容,或用 WriteTo 排空到另一个 io.Writer。因此,选择前先问一句:后续代码需要读取或修改字节吗?需要的话不要为了“看起来专门”强行使用 Builder。

只构造文本时,用 Builder 把边界写清楚

下面的函数明确返回字符串。预计总长度可估算时,Grow 可以提前保证后续 n 个字节的空间;它不是字符数,也不是追加次数。中文等 UTF-8 文本应按字节规模估算,估不准时宁可不填一个过大的数字。

package main

import "strings"

func renderTitle(parts []string) string {
	var b strings.Builder
	// Grow 的参数是预计追加的字节数,过大的预估会徒增占用。
	b.Grow(64)
	for i, part := range parts {
		if i > 0 {
			// 文本分隔符直接写入 Builder,避免先拼出临时字符串。
			b.WriteString(" / ")
		}
		b.WriteString(part)
	}
	return b.String()
}

这里没有调用 Bytes(),也没有把结果交给需要读取游标的组件,所以 Builder 的意图更明确。注意不要复制已经写入内容的 Builder;文档明确要求非零 Builder 不应被复制。需要并发构造时,为每个任务单独创建实例,并在任务边界返回最终字符串。

strings.Builder 与 string 输出边界的静态关系图
图1:Builder 只围绕文本追加和最终 string 输出组织,Grow 作用于内部字节容量。

需要 []byte、读取或写出时,用 Buffer

Buffer 的优势是接口更宽:写入内容后可以立刻读取,也可以把未读部分交给另一个 Writer。它还适合已有字节数据的缓冲场景,但 bytes.NewBuffer 会接管传入切片,调用后不应继续把原切片当作独立存储使用。

package main

import (
	"bytes"
	"io"
)

func copyPayload(dst io.Writer, payload []byte) error {
	var buf bytes.Buffer
	// Buffer 直接保存字节,适合后续排空到 io.Writer。
	_, _ = buf.Write(payload)
	_, err := buf.WriteTo(dst)
	return err
}

如果只是把一段固定 []byte 转成字符串,直接转换往往更简单;只有当中间确实需要缓冲、读取或增量写入时,Buffer 才是在表达真实需求。对大块已知数据,还可以用 buf.Grow(n),同样按字节数理解。

bytes.Buffer 在字节写入读取和输出之间的静态关系图
图2:Buffer 同时连接字节写入、未读字节读取与 Writer 输出,边界比单纯构造字符串更宽。

Grow、Bytes 和 Reset 的三个边界

场景更合适的类型关键边界
拼接文本并返回 stringstrings.BuilderGrow 按字节;非零值不要复制
需要读写 []bytebytes.BufferBytes() 只在下一次修改前可靠
排空到 io.Writerbytes.BufferWriteTo 遇到写出错误会返回
对象复用两者都可Reset 后不要保留会被后续写入影响的别名

尤其要小心 bytes.Buffer.Bytes():它返回的是未读部分的切片,并且可能与内部存储共享。若要跨越下一次写入长期保存,应复制一份;如果消费者只在当前调用中同步使用,直接传递才是合理的。两种类型都不是并发安全容器,跨 goroutine 共享时要在外层划清所有权。

一张速查表收敛选择

  • 返回值声明为 string,中途没有读指针:选 strings.Builder
  • 要取字节切片、读取缓冲区、调用 WriteTo 或接入读写协议:选 bytes.Buffer
  • 只因为担心分配而调用 Grow:先根据真实数据估算,并用基准测试验证,不要把容量预留当成性能保证。
  • 需要在多个请求间复用:每次开始前 Reset,并确认没有旧的 string 或 byte slice 仍指向内部数据。

简而言之,Builder 是“构造字符串”的窄工具,Buffer 是“管理字节流”的宽工具。按最终消费者选择,再处理容量、别名和所有权,通常比记忆某个绝对性能排名更可靠。

相关问题

Builder 可以替代 bytes.Buffer 吗?

只能替代其中“连续追加并最终转成字符串”的部分;如果调用方需要读取缓冲区或拿到可写字节,Builder 的接口和语义都不匹配。

Grow 传入字符串长度可以吗?

可以,但要传字节长度。对 UTF-8 文本,len(s) 返回的是字节数,而不是中文字符数;负数会触发 panic。

资料依据:https://pkg.go.dev/strings#Builderhttps://pkg.go.dev/bytes#Bufferhttps://go.dev/src/strings/builder.gohttps://go.dev/src/bytes/buffer.go

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>