Go strconv.AppendInt 拼接数字字段的性能方案

Go 中需要把订单号、分片号、重试次数等数字拼进日志或协议字段时，直接使用 strconv.AppendInt 往已有的 []byte 追加，通常比“先转成 string，再用字符串拼接”更容易控制中间对象。它返回扩展后的切片，所以每次调用都要接住返回值；十进制场景传入 base=10，最后只在确实需要字符串时做一次转换。

把数字字段直接写入目标缓冲区

strconv.AppendInt(dst, i, base) 会把整数的文本表示追加到 dst，返回值仍然是 []byte。这使字面量、分隔符和数字可以沿着同一条数据流写入，避免每个数字先产生一个独立字符串。下面的例子把三个字段按固定格式写进记录：

package main

import "strconv"

// appendRecord 将数字字段追加到调用方提供的缓冲区。
func appendRecord(dst []byte, orderID, shard, retry int64) []byte {
    // 先写固定文本，再让 AppendInt 追加数字，保持字段顺序稳定。
    dst = append(dst, "order_id="...)
    dst = strconv.AppendInt(dst, orderID, 10)
    dst = append(dst, ";shard="...)
    dst = strconv.AppendInt(dst, shard, 10)
    dst = append(dst, ";retry="...)
    return strconv.AppendInt(dst, retry, 10)
}

func main() {
    // 预留本条记录的大致容量，避免小容量切片频繁扩容。
    buf := make([]byte, 0, 64)
    buf = appendRecord(buf, 42018, 3, 1)
    _ = string(buf) // 只有边界需要字符串时才做一次转换。
}

这里最容易漏掉的是返回值：如果忽略某次 AppendInt 的结果，扩容后的底层数组可能已经换了，后续写入就会落在旧切片上。负数也不需要单独拼接减号，函数会把符号纳入结果。

容量、进制与类型边界要先定清

预留容量不是越大越好。可以依据字段数量、分隔符和数字位数给一个保守值；记录长度波动较大时，宁可接受少量扩容，也不要为每条请求分配一个很大的空闲区。批量写出时可以把缓冲区截回 buf[:0] 后复用，但前提是上一轮数据已经被消费，且没有把这个切片交给异步任务继续读取。

base 表示进制：普通日志和 JSON 外的文本字段通常用 10，十六进制标识才使用 16。AppendInt 接收的是 int64；如果输入是 int，应明确转换，并确认业务值不会因目标宽度而丢失。无符号数据使用 AppendUint，不要通过强制转换掩盖类型语义。

复用缓冲区时把所有权当成性能边界

单 goroutine 的批处理可以复用一个局部缓冲区；HTTP 服务或 worker 池中则应让每个任务拿到自己的切片，或者从明确的池中借出并在消费完成后归还。不能因为 AppendInt 本身只操作字节，就把共享切片当成线程安全对象。尤其是把 buf 转成字符串后仍异步使用时，要先确认转换后的字符串已经拥有所需数据，不能继续修改同一片底层存储。

建议把“构造记录”和“发送记录”分开：前者返回字节切片，后者负责消费；如果发送 API 会保留传入切片，就在接口边界复制，或者约定清晰的生命周期。这样性能优化不会悄悄变成数据串线。

用基准和检查清单确认优化是否成立

不要只凭“少了一次转换”就断言更快。可以为字符串拼接方案和字节追加方案分别写基准，关注 ns/op、B/op 与 allocs/op；示例命令如下，输出数字应以自己的 Go 版本和数据分布为准：

# 只运行追加数字字段相关基准，并显示每次操作的分配趋势。
go test -run '^$' -bench 'AppendInt|StringConcat' -benchmem ./...

# 代码中要覆盖正数、负数、零、长数字和多次扩容场景。

复查时按这五项走一遍：是否每次都接住返回值；十进制是否传入 10；输入类型是否匹配；缓冲区是否在消费后再复用；基准是否使用了与线上相近的字段长度。只有输出一致且生命周期安全，减少分配才有工程价值。

相关问题

AppendInt 能直接替代 fmt.Sprintf 吗？

只适合格式固定、主要工作是拼接整数的路径。复杂模板、调试输出或需要多种格式化规则时，仍应优先保证可读性，再用基准决定是否局部替换。

为什么调用后一定要重新赋值？

追加可能触发底层数组扩容，返回值才代表最新的切片长度和地址；忽略它会让后续操作继续使用旧视图。

AppendInt 的 base 应该怎么选？

人类可读数字通常选 10；只有协议明确要求其他进制时才使用对应值，并在测试中固定检查输出格式。