Go 中 Varint 编码与二进制字节读取的本质区别详解
技术百科
霞舞
发布时间:2026-01-20
浏览: 次 `binary.varint` 实现的是 protocol buffers 风格的变长整数编码(小端、7-bit 分块、msb 标志位),而 `binary.read` 是按指定字节序直接解析固定长度的原始二进制数据;二者语义完全不同,不可互换使用。
在 Go 标准库中,encoding/binary 包提供了两类截然不同的整数解析机制:定长二进制解析(如 binary.Read)和变长整数解码(binary.Varint)。它们面向完全不同的协议场景,混淆使用将导致严重逻辑错误。
? 本质差异解析
-
binary.Read(buf, order, &i)
将缓冲区中连续的 8 字节(对 int64)按指定字节序(如 LittleEndian)直接解释为一个完整整数。它不关心内容含义,只做“裸字节到数值”的机械映射。
在示例中:b := []byte{0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40} // LittleEndian 解析:0x400921FB54442D18 → 十进制 4614256656552045848 -
binary.Varint(b)
实现的是 Protocol Buffers 的 varint 编码规范:- 每个字节仅用低 7 位存储数据,最高位(MSB)作为“是否继续”标志;
- 数值按小端分组拼接
(但不是字节序意义上的小端,而是 LSB 优先的 bit-level 编码);
- 编码长度可变(1–10 字节),用于节省空间。
示例中 b[0] = 0x18(二进制 00011000),MSB = 0 → 结束,有效 7 位为 0011000 = 12,因此返回 12。
✅ 正确使用示例
package main
import (
"bytes"
"encoding/binary"
"fmt"
)
func main() {
// 场景 1:读取固定长度的 int64(如文件头、网络包字段)
raw := []byte{0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40}
var fixed int64
binary.Read(bytes.NewReader(raw), binary.LittleEndian, &fixed)
fmt.Printf("Fixed-size read: %d\n", fixed) // → 4614256656552045848
// 场景 2:解码 protobuf-style varint(如 gRPC、.proto 序列化数据)
varintBytes := []byte{0x18} // 0x18 = 0b00011000 → 7-bit payload 0b0011000 = 12
v, n := binary.Varint(varintBytes)
if n <= 0 {
panic("invalid varint")
}
fmt.Printf("Varint decode: %d (consumed %d bytes)\n", v, n) // → 12
}⚠️ 关键注意事项
- ❌ binary.Varint 不接受 bytes.Buffer 或 io.Reader —— 它只接收 []byte 并从索引 0 开始解析,且仅解码第一个 varint,忽略后续字节;
- ❌ 不要试图用 binary.Varint 解析 binary.Write 写出的数据(后者是定长原始字节);
- ✅ 若需序列化 varint,应使用 binary.PutUvarint / binary.PutVarint,而非 binary.Write;
- ? binary.Varint 返回的 n 表示实际消耗的字节数,务必校验 n > 0,避免静默失败。
理解并严格区分这两种机制,是正确处理二进制协议(如自定义通信格式、兼容 Protobuf 生态)的基础。选择依据始终是:你的数据源遵循哪种编码规范?
# ai
# 的是
# 第一个
# 它不
# 自定义
# 而非
# 这两种
# 哪种
# go
# 编码
# 字节
# 区别
# 标准库
# 序列化
# 定长
# 变长
相关栏目:
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
AI推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
SEO优化<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
技术百科<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
谷歌推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
百度推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
网络营销<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
案例网站<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
精选文章<?muma echo $count; ?>
】
相关推荐
- Python爬虫项目实战教程_Scrapy抓取与存
- 一文教你快速开通网站LOGO图
- 如何在Golang中编写异步函数测试_Golang
- c# F# 的 MailboxProcessor
- Win11系统占用空间大怎么办 Win11深度瘦身
- c++20的std::format怎么用 比pri
- Win11怎么开启专注模式_Windows11时钟
- c++如何使用std::bind绑定函数参数_c+
- c++协程和线程的区别 c++异步编程模型对比【核
- Win11怎么设置ipv4地址_Windows 1
- Python与MongoDB NoSQL开发实战_
- Win11怎么清理C盘虚拟内存_Win11清理虚拟
- Win11怎么更改账户头像_Windows 11自
- Python音视频处理高级项目教程_FFmpegP
- php怎么下载安装并配置环境变量_命令行调用PHP
- Windows10如何查看保存的WiFi密码_Wi
- 如何使用Golang处理网络超时错误_Golang
- Python类装饰器使用_元编程解析【教程】
- Win11怎么设置虚拟内存_Windows 11优
- Python网页解析流程_html结构说明【指导】
- Win11如何设置省电模式 Win11开启电池节电
- Win11怎么关闭定位服务 Win11禁止应用获取
- Win11怎么设置任务栏透明_Windows11使
- Windows10如何更改任务栏高度_Win10解
- 如何使用Golang实现容器安全扫描_Golang
- 如何使用Golang实现RPC序列化与反序列化_G
- php订单日志怎么在swoole写_php协程sw
- VSC怎么配置PHP的Xdebug_远程调试设置步
- Win11玩游戏全屏闪退怎么办_Win11全屏优化
- Win11如何设置系统语言_Win11系统语言切换
- Mac如何解压zip和rar文件?(推荐免费工具)
- php打包exe后无法写入文件_权限问题解决方法【
- php串口通信波特率怎么选_根据硬件手册设置正确波
- Windows怎样拦截WPS弹窗广告_Window
- Mac怎么安装软件_Mac安装dmg与pkg文件的
- Win11触摸板没反应怎么办_开启Win11笔记本
- 如何诊断并终止卡死的 multiprocessin
- Win11怎么设置默认输入法 Win11固定中文输
- Windows 11无法安全删除U盘提示设备正在使
- Python代码测试策略_质量保障解析【教程】
- Win10系统怎么查看网络连接状态_Windows
- Win11怎么打开旧版计算器_Win11恢复传统计
- php下载安装包怎么选_threadsafe与nt
- c++ nullptr与NULL区别_c++11空
- c++怎么设置线程优先级与cpu亲和性_c++ 多
- PHP主流架构怎么处理表单验证_规则与自定义【技巧
- 如何在同包不同文件中正确引用 Go 结构体
- Windows11怎么自定义任务栏_Windows
- c++中的CRTP是什么 c++奇异递归模板模式【
- Win11怎么更改默认打开方式_Win11关联文件


QQ客服