Go 中 Varint 编码与二进制字节读取的本质区别详解

`binary.varint` 实现的是 protocol buffers 风格的变长整数编码（小端、7-bit 分块、msb 标志位），而 `binary.read` 是按指定字节序直接解析固定长度的原始二进制数据；二者语义完全不同，不可互换使用。

在 Go 标准库中，encoding/binary 包提供了两类截然不同的整数解析机制：定长二进制解析（如 binary.Read）和变长整数解码（binary.Varint）。它们面向完全不同的协议场景，混淆使用将导致严重逻辑错误。

? 本质差异解析

• binary.Read(buf, order, &i)
  将缓冲区中连续的 8 字节（对 int64）按指定字节序（如 LittleEndian）直接解释为一个完整整数。它不关心内容含义，只做“裸字节到数值”的机械映射。
  在示例中：

  b := []byte{0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40}
  // LittleEndian 解析：0x400921FB54442D18 → 十进制 4614256656552045848

• binary.Varint(b)
  实现的是 Protocol Buffers 的 varint 编码规范：

  • 每个字节仅用低 7 位存储数据，最高位（MSB）作为“是否继续”标志；
  • 数值按小端分组拼接（但不是字节序意义上的小端，而是 LSB 优先的 bit-level 编码）；
  • 编码长度可变（1–10 字节），用于节省空间。
    示例中 b[0] = 0x18（二进制 00011000），MSB = 0 → 结束，有效 7 位为 0011000 = 12，因此返回 12。

✅ 正确使用示例

package main

import (
    "bytes"
    "encoding/binary"
    "fmt"
)

func main() {
    // 场景 1：读取固定长度的 int64（如文件头、网络包字段）
    raw := []byte{0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40}
    var fixed int64
    binary.Read(bytes.NewReader(raw), binary.LittleEndian, &fixed)
    fmt.Printf("Fixed-size read: %d\n", fixed) // → 4614256656552045848

    // 场景 2：解码 protobuf-style varint（如 gRPC、.proto 序列化数据）
    varintBytes := []byte{0x18} // 0x18 = 0b00011000 → 7-bit payload 0b0011000 = 12
    v, n := binary.Varint(varintBytes)
    if n <= 0 {
        panic("invalid varint")
    }
    fmt.Printf("Varint decode: %d (consumed %d b
ytes)\n", v, n) // → 12
}

⚠️ 关键注意事项

• ❌ binary.Varint 不接受 bytes.Buffer 或 io.Reader —— 它只接收 []byte 并从索引 0 开始解析，且仅解码第一个 varint，忽略后续字节；
• ❌ 不要试图用 binary.Varint 解析 binary.Write 写出的数据（后者是定长原始字节）；
• ✅ 若需序列化 varint，应使用 binary.PutUvarint / binary.PutVarint，而非 binary.Write；
• ? binary.Varint 返回的 n 表示实际消耗的字节数，务必校验 n > 0，避免静默失败。

理解并严格区分这两种机制，是正确处理二进制协议（如自定义通信格式、兼容 Protobuf 生态）的基础。选择依据始终是：你的数据源遵循哪种编码规范？