Go binary.AppendUvarint 怎么追加变长整数

Go 里要把一个 uint64 紧凑地追加到字节缓冲区，直接使用 encoding/binary.AppendUvarint：buf = binary.AppendUvarint(buf, value)。它不会从切片头部重新写入，而是把变长编码接在当前长度之后；数值越小，通常占用的字节越少。读取时用 binary.Uvarint，返回值和消费字节数都能帮助你判断输入是否完整。

Go binary.AppendUvarint 的追加关系与变长编码结构

这个函数的关键不是“把整数转成字符串”，而是把整数拆成多个 7 位片段。每个片段放进一个字节，若后面还有片段，就把最高位置为 1；最后一个字节最高位为 0。于是 0 只需要 1 个字节，接近 uint64 上限的值最多需要 10 个字节。

它与 PutUvarint 的使用方式不同：PutUvarint 要求调用方提前准备目标空间并返回写入长度；AppendUvarint 直接基于切片的 len 和 cap 追加，适合协议头、记录长度或多个字段连续拼接。下面的结构图只用于解释编码关系，不是运行截图。

用已有前缀追加 uint64 并用 Uvarint 读回

最小用法是接住返回值。只调用函数而不重新赋值，可能漏掉扩容后返回的新切片。示例用一个已有版本字节作为前缀，再追加 300，最后从偏移位置解码。

package main

import (
    "encoding/binary"
    "fmt"
)

func main() {
    buf := []byte{0x01} // 保留协议版本，后面的字段从这里继续追加
    buf = binary.AppendUvarint(buf, 300) // 300 会拆成两个变长编码字节

    value, n := binary.Uvarint(buf[1:]) // 跳过版本字节，只解码整数区域
    if n 

这里 buf 的第一个字节仍是前缀，编码结果追加在其后。Uvarint 的 n>0 才表示成功；不能只看返回的数值，因为截断输入和溢出时数值可能是 0。对于流式协议，应该把 n 与当前字段起点相加，推进下一个字段的偏移。

连续追加、容量复用和切片边界怎么处理

多个字段连续写入时，每次都把返回值接回同一个变量。切片有足够容量时，函数可能复用底层数组；容量不足时会分配新数组。因此不要在追加后继续把旧切片的尾部当成稳定视图，也不要在保存子切片时忽略下一次追加可能带来的重新分配。

func encodePair(a, b uint64) []byte {
    buf := make([]byte, 0, 2*binary.MaxVarintLen64) // 预留两个 uint64 的最坏空间
    buf = binary.AppendUvarint(buf, a)              // 先追加第一个字段
    buf = binary.AppendUvarint(buf, b)              // 再追加第二个字段
    return buf                                     // 返回最终长度，而不是 cap
}

预留容量不是必须条件，只是当字段数量已知时可以减少扩容。真正的编码长度取决于数值：小整数只占一个字节，不能用固定的 MaxVarintLen64 当作每个字段的实际长度。若要截取字段，应在追加前记录 start := len(buf)，追加后用 buf[start:] 获取本次产生的编码。

10 字节上限与有符号整数的边界

binary.MaxVarintLen64 是 uint64 变长编码的最大字节数。解码时如果缓冲区只有半个字段，Uvarint 会返回 n=0；如果超过 64 位范围，则返回负的字节计数。网络读取或文件分块场景必须保留未完成的尾部，不能把一次读取得到的 n=0 当成永久坏数据。

另一个常见坑是把 int64 直接转换成 uint64 后再调用 AppendUvarint。负数会变成很大的无符号数，编码长度也可能接近 10 字节。如果字段本来就是有符号整数，应使用 binary.AppendVarint(buf, value)，并在协议说明中固定对应的解码方式。

相关问题

AppendUvarint 会覆盖已有字节吗？

不会。它从传入切片的当前长度位置追加；只有底层数组复用时，新增区域可能写入原切片容量范围内尚未使用的空间。

为什么调用后长度没有变化？

最常见原因是没有接住返回值，例如只写 binary.AppendUvarint(buf, x)。应改为 buf = binary.AppendUvarint(buf, x)。

PutUvarint 和 AppendUvarint 怎么选？

已经有固定写入位置、希望避免切片增长时可用 PutUvarint；需要把字段自然接到动态缓冲区时用 AppendUvarint，代码更直接。