0

0

Go 中使用 binary.Varint 解析单字节时结果减半的原因与解决方案

花韻仙語

花韻仙語

发布时间:2026-01-12 18:37:12

|

944人浏览过

|

来源于php中文网

原创

Go 中使用 binary.Varint 解析单字节时结果减半的原因与解决方案

`binary.varint` 专为有符号整数的变长编码设计,会将输入按 zigzag 编码规则解码(右移1位 + 符号位判断),导致 `byte(18)` 被误解析为 `9`;应改用 `binary.uvarint` 处理无符号字节序列。

在 Go 的 encoding/binary 包中,Varint 和 Uvarint 是两个关键但语义迥异的函数:

  • binary.Uvarint(buf []byte) 用于解码 无符号变长整数(如 uint64),直接按 Base128 规则累加有效位,适用于 byte(即 uint8)、uint16、uint32 等原始无符号值;
  • binary.Varint(buf []byte) 则专为 有符号整数的 ZigZag 编码 设计——它先调用 Uvarint 获取原始无符号值,再通过 x = (ux >> 1) ^ -(ux & 1) 进行 ZigZag 反变换,以支持负数高效编码(常用于 Protocol Buffers)。

你示例中的 byte(18) 二进制为 00010010(8 位),传入 Varint 后流程如下:

  1. 内部调用 Uvarint(array) 得到 ux = 18;
  2. 执行 x = int64(ux >> 1) → 18 >> 1 = 9(即 00001001);
  3. 检查 ux & 1 == 0(18 & 1 = 0),不满足 ux&1 != 0 条件,跳过取反;
  4. 最终返回 x = 9 —— 这正是输出 value: 9 的根本原因。

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

Frase
Frase

Frase是一款出色的长篇 AI 写作工具,快速创建seo优化的内容。

下载
package main

import (
    "fmt"
    "encoding/binary"
)

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

    // ❌ 错误:Varint 期望 ZigZag 编码的有符号值
    val, n := binary.Varint(array)
    fmt.Printf("Varint -> value: %d, num bytes: %d\n", val, n) // 输出: 9, 1

    // ✅ 正确:Uvarint 直接解码无符号变长整数
    uval, un := binary.Uvarint(array)
    fmt.Printf("Uvarint -> value: %d, num bytes: %d\n", uval, un) // 输出: 18, 1
}

⚠️ 注意事项:

  • Varint/Uvarint 均要求输入字节切片符合 LEB128(Little-Endian Base128)格式:每个字节低 7 位存数据,最高位(bit 7)为 continuation bit(1 表示后续还有字节,0 表示结束)。单字节 []byte{18} 是合法的 LEB128 编码(18 < 128,continuation bit = 0),因此能被正确解析;
  • 若需编码 int64 类型的有符号值并保证跨语言兼容(如与 Protobuf 交互),才应先用 binary.PutVarint 编码,再用 Varint 解码;普通无符号数值场景请坚持 Uvarint;
  • Varint 返回 int64,Uvarint 返回 uint64,注意类型匹配,避免隐式转换引发意外截断或符号扩展。

总结:byte 是 uint8 的别名,天然无符号;选择解码函数的核心原则是——编码方式决定解码方式。用 Uvarint 解 uint,用 Varint 解经 ZigZag 编码的 int,二者不可混用。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1091

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

620

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

356

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

235

2025.08.29

go语言 数组和切片
go语言 数组和切片

本专题整合了go语言数组和切片的区别与含义,阅读专题下面的文章了解更多详细内容。

57

2025.09.03

bootstrap框架介绍
bootstrap框架介绍

本专题整合了bootstrap框架相关介绍,阅读专题下面的文章了解更多详细内容。

0

2026.03.18

vscode 格式化
vscode 格式化

本专题整合了vscode格式化相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.03.18

vscode设置中文教程
vscode设置中文教程

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

0

2026.03.18

vscode更新教程合集
vscode更新教程合集

本专题整合了vscode更新相关内容,阅读专题下面的文章了解更多详细教程。

2

2026.03.18

热门下载

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

精品课程

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

共32课时 | 6.4万人学习

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

共10课时 | 0.9万人学习

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

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