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

百度文心一格
百度文心一格

百度推出的AI绘画作图工具

下载
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
  • 若需编码 int64 类型的有符号值并保证跨语言兼容(如与 Protobuf 交互),才应先用 binary.PutVarint 编码,再用 Varint 解码;普通无符号数值场景请坚持 Uvarint;
  • Varint 返回 int64,Uvarint 返回 uint64,注意类型匹配,避免隐式转换引发意外截断或符号扩展。

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

相关专题

更多
string转int
string转int

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

315

2023.08.02

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

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

534

2024.08.29

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

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

52

2025.08.29

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

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

194

2025.08.29

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

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

46

2025.09.03

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

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

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

106

2026.01.09

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

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

63

2026.01.09

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

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

139

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号