strconv.AppendQuote 怎样把字符串追加到已有字节缓冲区

直接结论：strconv.AppendQuote 适合把一个字符串编码成 Go 双引号字符串字面量，并直接追加到已有的 []byte。关键是必须接住返回值：它可能复用原切片，也可能在容量不足时返回新的底层数组。

如果输出本来就在字节缓冲区里，AppendQuote 比先调用 Quote 再把结果转成字节追加更顺手。它处理引号、换行和不可打印字符的转义，但目标是 Go 字符串字面量，不是 JSON、HTML 或 URL 编码器。

一、最小写法：先接住返回值

把前缀作为第一个参数，把待编码字符串作为第二个参数，再用返回值覆盖原变量：

package main

import (
	"fmt"
	"strconv"
)

func main() {
	// 预留少量容量，演示把结果继续写入已有缓冲区。
	buf := make([]byte, 0, 32)
	buf = append(buf, "name=")
	// 返回值可能指向扩容后的切片，不能忽略。
	buf = strconv.AppendQuote(buf, "Go \"tips\"\n")
	fmt.Println(string(buf))
}

结果会保留前缀，并把输入中的双引号和换行表示成 Go 转义形式。这里的 buf = 不是写法偏好，而是切片追加 API 的基本使用方式。

二、它追加了什么：前缀、引号和转义

AppendQuote(dst, s) 可以拆成三个观察点：

• dst：已有字节会保留在结果前面，容量足够时有机会原地复用。
• s：原始字符串不会直接照搬，双引号、控制字符等会按 Go 字符串字面量规则转义。
• 返回值：它是扩展后的完整切片，后续应继续使用这个值。

需要连续追加多个字段时，可以把返回值一直接下去：

func encodePair(left, right string) []byte {
	// 先设置稳定前缀，减少后面重复创建字符串。
	dst := make([]byte, 0, len(left)+len(right)+16)
	dst = append(dst, "left=")
	dst = strconv.AppendQuote(dst, left)
	dst = append(dst, " right=")
	dst = strconv.AppendQuote(dst, right)
	return dst
}

容量估算只能减少扩容机会，不能保证零分配；引号和转义后的长度可能比原始字符串更长。

三、用指标判断是否值得替换

不要只凭“少了一次字符串转换”下性能结论。固定输入、初始容量和 Go 版本，再比较 ns/op、B/op 与 allocs/op：

func BenchmarkAppendQuote(b *testing.B) {
	input := "Go \"tips\"\n"
	b.ReportAllocs()
	for i := 0; i 

这段代码是测量模板，不代表固定结果。短字符串、长字符串、转义密集字符串和不同初始容量，都可能改变分配次数和耗时。只有在真实输入下重复基准，才适合决定是否替换。

四、常见边界与速查

相关问题

AppendQuote 会修改传入的底层数组吗？

容量足够时可能复用底层数组；容量不足时会扩容并返回新切片。因此调用方只应依赖返回值，不应依赖底层数组地址。

为什么结果长度可能比输入长？

外层双引号和转义序列都会增加长度，例如换行需要用转义表示。用原始字符串长度估算容量时要给出余量。

AppendQuote 能替代 JSON 编码吗？

不能。它表达的是 Go 字符串字面量；协议编码要遵循协议自身的转义、字符集和结构规则。