binary.Varint 将 0x18 解为 12 而非 24，是因为它执行 ZigZag 解码：先按 LEB128 得 ux=24，再计算 (24>>1)^-(24&1)=12；这是为有符号整数设计的协议行为，非 bug。
binary.Varint 为什么把 0x18 解成 12 而不是 24
因为 binary.Varint 不是简单取低 7 位，而是按 Protocol Buffers 的 LEB128 规则逐字节右移累加：对 []byte{0x18}，它先做 0x18 & 0x7F 得到 24，再右移 1 位（ZigZag 解码步骤），得 12。这不是 bug，是明确为有符号整数设计的 ZigZag 逆运算。
常见错误现象：传入一个原始 uint8(18) 却用 Varint 解，结果变成 9；传入 0x18（即十进制 24）却得 12——本质都是误把无符号原始值当作了 ZigZag 编码后的有符号序列。
- Varint 专用于解码 protobuf 中的
sint32/sint64字段，底层强制走 ZigZag - 若你协议里存的是普通计数器、ID、长度等非负值，必须用
Uvarint -
Varint返回int64是为了签名兼容，但内部按uint64解再转符号，高位为 1 时可能意外符号扩展
Uvarint 和 Varint 在字节流里实际怎么分界
binary.Uvarint 和 binary.Varint 都只读取“第一个 varint”，从切片开头开始，按 MSB 标志位判断是否继续：每个字节最高位为 1 表示后面还有字节，为 0 表示结束。它们不关心后续字节，也不校验总长度。
例如 []byte{0x82, 0x01, 0xFF}：Uvarint 读前两字节（0x82 & 0x7F = 0x02，左移 7；0x01 & 0x7F = 0x01，拼成 0x0102 = 258），返回 258 和 n=2；第三个字节 0xFF 完全被忽略。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 两者都只接受
[]byte，不支持io.Reader或bytes.Buffer - 返回的
n是消耗字节数，必须检查n > 0，否则可能是空切片或非法编码（如全 0x80） - 若字节流含多个 varint（如 gRPC payload），需手动移动切片偏移反复调用，不能一次全喂进去
什么时候该用 binary.Read，而不是 Uvarint
binary.Read 是定长原始字节解释器，Uvarint 是变长编码解码器——二者协议语义完全不重叠。你协议头里写的是 “4 字节大端长度字段”，就该用 binary.Read(r, binary.BigEndian, &len)；你协议文档写的是 “length 字段采用 varint 编码”，才轮到 Uvarint。
典型混淆场景：用 binary.Write 写出一个 int64，再拿 Uvarint 去读——必然失败。因为 Write 输出 8 个裸字节，而 Uvarint 期望的是 LEB128 编码（如 127 只占 1 字节，128 占 2 字节）。
- 固定长度字段（魔数、版本、时间戳、IPv4 地址）→ 无条件选
binary.Read - 可变长度字段（消息体长度、数组元素个数、稀疏 ID）→ 查协议是否明确标注 “varint” 或 “LEB128”
- 别试图用
Uvarint解析binary.Write的输出；同理，别用binary.Read解 protobuf 的 varint 字段
解析 varint 时最容易被忽略的边界问题
最隐蔽的坑不在编码逻辑，而在字节来源和内存安全：varint 编码最长 10 字节（对应 uint64 上限），但如果你从网络读取时只预分配了 8 字节缓冲区，Uvarint 就会越界读——它不检查切片长度，只按 MSB 往后扫，遇到越界 panic 或静默读到脏内存。
- 从
io.Reader读 varint 前，务必先读满至少 10 字节到本地缓冲区，再传给Uvarint - 若协议允许最大值远小于
2^64（比如 ID 永远），可提前截断切片长度防攻击 - 在 TCP 粘包场景下，varint 长度字段本身可能跨包——必须确保整个 varint 字节完整到达后再调用
Uvarint，不能靠单次Read
