bytes.buffer 是 go 中专为二进制数据设计的轻量级可变字节容器，基于 []byte 封装，不涉及编码转换；string 因只读且语义为 utf-8 文本，不适合拼接原始二进制数据。
bytes.Buffer 是 Go 中处理二进制数据最轻量、最常用的可变字节容器，它不是字符串工具，而是 []byte 的封装体，所有操作都基于字节流，不涉及编码转换。
为什么不能直接用 string 拼接二进制数据
Go 中 string 是只读的 UTF-8 编码文本，底层虽是字节序列，但语义上不允许修改、也不保证内容是合法 UTF-8。用 string 拼接图片头、加密密文、协议帧等原始二进制数据，容易触发不可见的截断或 panic（比如含 \x00 时某些 C 绑定会误判为字符串结尾）。
而 bytes.Buffer 明确设计为字节缓冲区：内部持有 []byte，支持追加、读取、重置，且所有方法（Write、WriteByte、WriteString）都按字节处理 —— WriteString 也只是把字符串底层字节拷过去，不做任何解码。
- 不要用
string存储或拼接非文本二进制数据 - 当需要动态构造 HTTP body、序列化结构、组装网络包时，优先选
bytes.Buffer -
bytes.Buffer的String()方法仅用于调试输出，返回的是 UTF-8 兼容部分的字符串视图，不能反向依赖它还原原始二进制
如何安全写入和读取原始字节
写入必须用 Write、WriteByte 或 WriteRune（后者仅在需 UTF-8 编码单个 rune 时用），避免隐式类型转换带来的歧义。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
读取推荐用 Bytes() 获取当前全部字节切片（只读视图，不拷贝），或 Next(n) / Read(p) 做流式消费；String() 仅限日志打印，且要确认内容确实可显示。
var buf bytes.Buffer
buf.WriteByte(0xFF)
buf.Write([]byte{0xCA, 0xFE, 0xBA, 0xBE})
buf.Write([]byte("hello")) // 实际写入 h e l l o 五个 ASCII 字节
// 安全获取原始字节
data := buf.Bytes() // 类型是 []byte，可直接传给 crypto/aes.Write 或 net.Conn.Write
// 错误示范：buf.String() 返回 "hello"，但前面的 0xFF/0xCAFE... 全部丢失或乱码
-
WriteString可用，但它只是快捷写入字符串底层字节，不校验是否合法 UTF-8 -
Bytes()返回的切片与 buffer 内部底层数组共享内存，若后续调用Write可能导致 slice 失效（因为底层数组可能扩容重分配） - 如需长期持有字节副本，用
copy(dst, buf.Bytes())或append([]byte(nil), buf.Bytes()...)
性能关键点：预分配容量和复用实例
bytes.Buffer 底层是动态切片，频繁小写入会触发多次内存分配与拷贝。HTTP server 中每个请求都 new 一个 Buffer 并写入几 KB 数据，GC 压力明显上升。
- 已知大致大小时，用
bytes.NewBuffer(make([]byte, 0, 4096))预分配容量 - 高并发场景下，用
sync.Pool复用*bytes.Buffer实例，注意每次 Get 后必须调用Reset()清空状态 - 避免在循环中反复
new(bytes.Buffer)，尤其在中间件或序列化函数里
var bufPool = sync.Pool{
New: func() interface{} {
return new(bytes.Buffer)
},
}
func handleRequest() {
buf := bufPool.Get().(*bytes.Buffer)
defer func() {
buf.Reset()
bufPool.Put(buf)
}()
buf.Grow(1024) // 提示至少预留空间
buf.Write(header)
buf.Write(payload)
// ...
}
真正容易被忽略的是：Buffer 的 Len() 和 Cap() 行为不像普通切片那样直观 —— 它的 Cap() 是底层切片容量，但 Len() 是已写入长度；重用前不 Reset()，旧数据残留会导致静默错误。另外，bytes.Buffer 不是线程安全的，多 goroutine 并发写必须加锁或换用 sync.Pool 隔离实例。
