Go 中使用 binary.Varint 解码字节时为何结果减半？

go 中使用 binary.varint 解码字节时为何结果减半？`binary.varint` 专为有符号整数的变长编码设计，会将输入按 zigzag 编码规则解码（右移1位+条件取反），导致 `byte(18)` 被误解析为 `9`；应改用 `binary.uvarint` 解码无符号值。

在 Go 的 encoding/binary 包中，Varint 和 Uvarint 虽然都用于变长整数编码（如 Protocol Buffers 所用），但语义截然不同：

• ✅ binary.Uvarint(buf []byte)：解码无符号整数（uint64），直接按 little-endian base-128 规则还原原始值；
• ❌ binary.Varint(buf []byte)：解码有符号整数（int64），但并非直接读取补码，而是按 ZigZag 编码（Protocol Buffers 标准）逆向解析 —— 即先当作 uint64 解码，再执行 x = (ux >> 1) ^ -(ux & 1)（等价于 ux&1 != 0 ? ^x : x）。

你示例中的 byte(18) 对应二进制 00010010，传入 Varint 后流程如下：

ux, n := Uvarint([]byte{18}) // ux = 18 (0b00010010)
x := int64(ux >> 1)           // x = 9  (0b00001001)
if ux&1 != 0 { x = ^x }       // 18&1 == 0 → 不取反 → 返回 9

因此输出 value: 9, num bytes: 1 是 ZigZag 解码的正确行为，而非 bug —— 它本就假设输入是 ZigZag 编码后的有符号值（例如 -9 的 ZigZag 编码恰好是 18）。

✅ 正确做法：因 byte 是 uint8 别名，天然无符号，应使用 Uvarint：

package main

import (
    "fmt"
    "encoding/binary"
)

func main() {
    var myByte byte = 18
    array := []byte{myByte}

    // ✅ 正确：解码无符号值
    val, n := binary.Uvarint(array)
    fmt.Printf("Uvarint → value: %d, num bytes: %d\n", val, n) // 输出: 18, 1

    // ❌ 错误：Varint 用于有符号 ZigZag 编码场景
    signedVal, _ := binary.Varint(array)
    fmt.Printf("Varint   → value: %d, num bytes: %d\n", signedVal, n) // 输出: 9, 1
}

⚠️ 注意事项：

• Varint/Uvarint 的输入必须是 Protocol Buffers 格式的变长字节序列（非任意单字节）；单字节 []byte{18} 仅对 ≤ 127 的 Uvarint 有效（最高位为 0 表示结束）。
• 若需编码/解码标准 Go 整数（如 int、uint），请确保数据来源符合 ZigZag（Varint）或纯 base-128（Uvarint）规范。
• Varint 的设计目标是高效存储小绝对值的有符号数（如 -1, 0, 1 编码后均为 1 字节），而非通用字节转整数工具。

总结：不要用 Varint 处理原始无符号字节。明确数据语义 —— 无符号用 Uvarint，有符号且经 ZigZag 编码才用 Varint。