0

0

Go 中使用 binary.Varint 解码字节时结果减半的原因与原理详解

霞舞

霞舞

发布时间:2026-01-11 23:25:02

|

738人浏览过

|

来源于php中文网

原创

Go 中使用 binary.Varint 解码字节时结果减半的原因与原理详解

`binary.varint` 专为有符号整数设计,它将输入字节按 zigzag 编码规则解码:先右移一位再根据最低位决定是否取反;而 `byte` 本质是 `uint8`(无符号),直接用 `varint` 会导致数值被错误解析(如 18 变成 9)。应改用 `binary.uvarint` 解码无符号值。

在 Go 的 encoding/binary 包中,Varint 和 Uvarint 虽然都用于变长整数编码/解码,但语义截然不同:

  • binary.Uvarint([]byte):解码 无符号 整数(uint64),适用于原始字节流中存储的正整数值(如 byte、uint8、uint16 等);
  • binary.Varint([]byte):解码 有符号 整数(int64),内部采用 ZigZag 编码,专为 Protocol Buffers 等场景优化,可高效表示负数且避免符号位浪费。

你示例中的 myByte = 18 是一个 uint8,二进制为 00010010。当调用 binary.Varint 时,其底层逻辑如下(摘自 Go 源码):

func Varint(buf []byte) (int64, int) {
    ux, n := Uvarint(buf) // 先以无符号方式读取 → ux = 18
    x := int64(ux >> 1)   // 右移一位 → 18 >> 1 = 9(即 00010010 → 00001001)
    if ux&1 != 0 {        // 检查原值最低位是否为 1
        x = ^x            // 若是,则按 ZigZag 规则取反(表示负数)
    }
    return x, n
}

由于 18 & 1 == 0,跳过取反,最终返回 9 —— 这正是你观察到的“结果减半”的根本原因:ZigZag 解码强制将输入视为已编码的有符号值,而你的字节并未经过 ZigZag 编码

✅ 正确做法:对原始无符号字节(如 []byte{18}),始终使用 Uvarint:

Bing图像创建器
Bing图像创建器

必应出品基于DALL·E的AI绘图工具

下载
package main

import (
    "fmt"
    "encoding/binary"
)

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

    // ❌ 错误:Varint 期望 ZigZag 编码的有符号值
    // val, n := binary.Varint(array) // → value: 9, num bytes: 1

    // ✅ 正确:Uvarint 直接解码无符号整数
    val, n := binary.Uvarint(array) // → value: 18, num bytes: 1
    fmt.Printf("value: %d, num bytes: %d\n", val, n)
}

⚠️ 注意事项:

  • Uvarint 要求输入字节是标准的 unsigned LEB128 编码(Little-Endian Base 128),单字节 18 符合该格式(最高位为 0,表示结束);
  • Varint 的输入必须是经 ZigZag 编码的字节(例如 int32(-1) 的 ZigZag 编码是 0xFF, 0x01),直接传入原始 uint8 值属于类型误用;
  • 若需序列化有符号整数,请先用 binary.PutVarint 编码,再用 binary.Varint 解码,确保编解码逻辑对称。

总结:类型匹配是关键——byte → uint8 → Uvarint;int64(含负数)→ Varint(配合 ZigZag)。混淆二者将导致静默的逻辑错误,而非 panic,务必在协议设计和序列化层明确数据的符号性。

相关专题

更多
高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

40

2026.01.16

全民K歌得高分教程大全
全民K歌得高分教程大全

本专题整合了全民K歌得高分技巧汇总,阅读专题下面的文章了解更多详细内容。

65

2026.01.16

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

21

2026.01.16

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

33

2026.01.15

Java音频处理教程汇总
Java音频处理教程汇总

本专题整合了java音频处理教程大全,阅读专题下面的文章了解更多详细内容。

16

2026.01.15

windows查看wifi密码教程大全
windows查看wifi密码教程大全

本专题整合了windows查看wifi密码教程大全,阅读专题下面的文章了解更多详细内容。

56

2026.01.15

浏览器缓存清理方法汇总
浏览器缓存清理方法汇总

本专题整合了浏览器缓存清理教程汇总,阅读专题下面的文章了解更多详细内容。

15

2026.01.15

ps图片相关教程汇总
ps图片相关教程汇总

本专题整合了ps图片设置相关教程合集,阅读专题下面的文章了解更多详细内容。

9

2026.01.15

ppt一键生成相关合集
ppt一键生成相关合集

本专题整合了ppt一键生成相关教程汇总,阅读专题下面的的文章了解更多详细内容。

26

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.8万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号