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:

小蓝本
小蓝本

ToB智能销售增长平台

下载
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,务必在协议设计和序列化层明确数据的符号性。

相关专题

更多
c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

79

2026.01.09

c++框架学习教程汇总
c++框架学习教程汇总

本专题整合了c++框架学习教程汇总,阅读专题下面的文章了解更多详细内容。

46

2026.01.09

学python好用的网站推荐
学python好用的网站推荐

本专题整合了python学习教程汇总,阅读专题下面的文章了解更多详细内容。

121

2026.01.09

学python网站汇总
学python网站汇总

本专题整合了学python网站汇总,阅读专题下面的文章了解更多详细内容。

12

2026.01.09

python学习网站
python学习网站

本专题整合了python学习相关推荐汇总,阅读专题下面的文章了解更多详细内容。

15

2026.01.09

俄罗斯手机浏览器地址汇总
俄罗斯手机浏览器地址汇总

汇总俄罗斯Yandex手机浏览器官方网址入口,涵盖国际版与俄语版,适配移动端访问,一键直达搜索、地图、新闻等核心服务。

71

2026.01.09

漫蛙稳定版地址大全
漫蛙稳定版地址大全

漫蛙稳定版地址大全汇总最新可用入口,包含漫蛙manwa漫画防走失官网链接,确保用户随时畅读海量正版漫画资源,建议收藏备用,避免因域名变动无法访问。

370

2026.01.09

php学习网站大全
php学习网站大全

精选多个优质PHP入门学习网站,涵盖教程、实战与文档,适合零基础到进阶开发者,助你高效掌握PHP编程。

45

2026.01.09

php网站搭建教程大全
php网站搭建教程大全

本合集专为零基础用户打造,涵盖PHP网站搭建全流程,从环境配置到实战开发,免费、易懂、系统化,助你快速入门建站!

12

2026.01.09

热门下载

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

精品课程

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

共32课时 | 3.6万人学习

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号