Go strconv.AppendInt 如何在日志缓冲区中追加整数

日志里追加请求编号、耗时或重试次数时，最小可用写法是把 strconv.AppendInt 的返回值重新赋给缓冲区：buf = strconv.AppendInt(buf, value, 10)。它直接把整数的文本表示追加到 []byte，省去先生成字符串再拼接的一层中间结果。

先把整数追加到可复用的日志缓冲区

下面的例子把一行日志拆成固定前缀、动态整数和换行符。缓冲区由调用方持有，下一行开始时可以用 buf[:0] 复用长度；AppendInt 返回的切片才是追加后的真实结果。

package main

import (
    "fmt"
    "strconv"
)

func appendLog(buf []byte, requestID int64, costMS int64) []byte {
    // 先复用调用方的容量，避免每个字段都创建临时字符串。
    buf = append(buf, "request_id="...)
    buf = strconv.AppendInt(buf, requestID, 10)
    buf = append(buf, " cost_ms="...)
    buf = strconv.AppendInt(buf, costMS, 10)
    // 日志行以换行结束，便于批量写入文件或网络连接。
    return append(buf, '\n')
}

func main() {
    // 预留一行的大致容量；不足时 Go 会自动扩容。
    buf := make([]byte, 0, 64)
    buf = appendLog(buf[:0], 42, 18)
    fmt.Print(string(buf))
}

这里有两个容易漏掉的细节。第一，AppendInt 的输入类型是 int64，普通 int 需要显式转换，并确认转换符合业务范围。第二，不能只调用函数而忽略返回值：

// 错误：返回切片可能已经换了底层数组，buf 不一定包含追加结果。
strconv.AppendInt(buf, requestID, 10)

// 正确：始终使用函数返回的切片继续追加。
buf = strconv.AppendInt(buf, requestID, 10)

base 不是格式装饰，而是日志协议的一部分

base 决定数字的文本进制。业务日志中的 ID、计数和耗时通常用十进制，传入 10 最容易被检索和人工阅读；调试位掩码或二进制协议时，才应该把进制明确改为 16 或其他允许值。

不要让同一个字段在不同日志路径中一会儿十进制、一会儿十六进制，否则下游解析和检索会变得含糊。进制应当由字段协议决定，而不是由调用者临时选择。

负数、最小值和容量增长怎么判断

AppendInt 会保留负号，并负责把 int64 的值转换为对应进制文本。包括 math.MinInt64 在内的边界值也应交给标准库处理，不要自行先取绝对值；自行取绝对值很容易在最小值上溢出。

容量方面，切片容量足够时可以沿用原底层数组，不足时会扩容。因此高频路径可以按一行日志的常见长度预留容量，但不要把“预留了 64 字节”当成永远不会分配的保证：字段变长、前缀增加或批量策略变化，都可能触发扩容。

func appendHex(buf []byte, value int64) []byte {
    // 十六进制只用于调试字段，正式协议不要和十进制混用。
    buf = append(buf, "value=0x"...)
    buf = strconv.AppendInt(buf, value, 16)
    return append(buf, '\n')
}

用基准确认它是否适合你的日志路径

如果目标是减少高频日志拼接的临时对象，可以把两条路径放进同一个基准：一条使用 AppendInt，另一条使用 FormatInt 后再追加。基准只比较相同的字段和输出，避免把 I/O、锁竞争或日志采样策略混进结论。

func BenchmarkAppendInt(b *testing.B) {
    // 复用容量并重置长度，只测整数追加和固定前缀。
    buf := make([]byte, 0, 64)
    b.ReportAllocs()
    for i := 0; i 

实际对比时重点看 ns/op、B/op 和 allocs/op，并用线上常见的数值范围重复测试。若日志最终还要复制、压缩或写入网络，整数格式化只是总耗时的一部分，不能只凭一个微型基准改动整体架构。

常见问题

AppendInt 会修改传入的原切片吗？

它会把结果追加到传入切片的可用容量中，容量不足时返回扩容后的新切片。因此应始终接收返回值。

为什么日志里一般传 10？

十进制更适合检索、阅读和与常规业务数值对照。十六进制应限于协议或调试字段。

能不能把 int 直接传给 AppendInt？

不能直接传，函数参数是 int64。转换前应确认数值范围，并避免把无符号值错误转换成负数。

AppendInt 一定比 FormatInt 更快吗？

它减少了显式字符串中间态的机会，但最终结果仍取决于缓冲区复用、扩容和后续 I/O。用同一业务负载基准测试才有意义。