Python struct.unpack() 用法及常见错误详解
更新时间：2025年06月05日 11:05:25 作者：极客不孤独
struct.unpack() 是 Python 中用于将二进制数据（字节序列）解析为 Python 数据类型的函数,通常与 struct.pack() 配对使用,下面给大家介绍Python struct.unpack()用法及常见错误,感兴趣的朋友一起看看吧
struct.unpack() 是 Python 中用于将二进制数据（字节序列）解析为 Python 数据类型的函数，通常与 struct.pack() 配对使用。它根据指定的格式字符串（format string）解析字节流，并返回一个包含解析结果的元组。
一、函数语法
struct.unpack(format, buffer)
- format：格式字符串，定义数据的解析规则（字节顺序、数据类型、数量等）。
- buffer：包含二进制数据的缓冲区（如
bytes、bytearray或支持缓冲协议的对象）。
返回值：包含解析后数据的元组。
二、格式字符串详解
格式字符串由两部分组成：
字节顺序/对齐字符（可选）：
| 字符 | 含义 | 大小端 |
|---|---|---|
@ | 本地顺序（默认） | 系统依赖 |
= | 本地标准大小 | 系统依赖 |
< | 小端（Little-Endian） | 低位在前 |
> | 大端（Big-Endian） | 高位在前 |
! | 网络顺序（大端） | RFC 标准 |
数据类型字符（必选）：
| 字符 | C 类型 | Python 类型 | 字节数 |
|---|---|---|---|
x | 填充字节 | 跳过字节 | 1 |
c | char | bytes (长度1) | 1 |
b | signed char | int | 1 |
B | unsigned char | int | 1 |
? | _Bool | bool | 1 |
h | short | int | 2 |
H | unsigned short | int | 2 |
i | int | int | 4 |
I | unsigned int | int | 4 |
l | long | int | 4 |
L | unsigned long | int | 4 |
q | long long | int | 8 |
Q | unsigned long long | int | 8 |
f | float | float | 4 |
d | double | float | 8 |
s | char[] | bytes | 长度见下文 |
p | Pascal 字符串 | bytes | 1+长度 |
P | void* | int | 系统依赖 |
特殊用法：
特殊用法：
s：需指定长度，如10s表示解析 10 字节的字符串。- 数字前缀：
3I表示连续解析 3 个无符号整数。
三、使用示例
示例 1：解析整数和浮点数
import struct
# 二进制数据：小端顺序 (<) + int (i) + float (f)
buffer = b'\x01\x00\x00\x00\xcd\xcc\x8c@'
data = struct.unpack('<if', buffer) # 解析1个int和1个float
print(data) # 输出: (1, 7.000000476837158)示例 2：解析字符串
# 数据：大端 (>) + 4字节字符串 (4s)
buffer = b'ABCD'
data = struct.unpack('>4s', buffer)
print(data) # 输出: (b'ABCD',)示例 3：解析混合类型
# 数据：小端 (<) + short (h) + 3字节字符串 (3s) + float (f)
buffer = b'\x01\x00XYZ\x00\x00\x80?'
data = struct.unpack('<h3sf', buffer)
print(data) # 输出: (1, b'XYZ', 1.0)示例 4：跳过填充字节
# 格式: 小端 (<) + char (c) + 填充1字节 (x) + int (i)
buffer = b'A\x00\x02\x00\x00\x00'
data = struct.unpack('<cx i', buffer)
print(data) # 输出: (b'A', 2)示例 5：解析数组
# 解析3个连续的 unsigned short (H)
buffer = b'\x01\x00\x02\x00\x03\x00'
data = struct.unpack('<3H', buffer)
print(data) # 输出: (1, 2, 3)四、关键注意事项
缓冲区长度必须匹配
使用 struct.calcsize(format) 验证格式字符串所需的字节数：
fmt = '<2i f' buffer = b'\x00' * struct.calcsize(fmt) # 创建匹配长度的缓冲区
字节顺序至关重要
大端/小端错误会导致解析数值异常：
# 错误示例：大端数据用小端解析
buffer = b'\x00\x00\x00\x01' # 大端表示的整数 1
struct.unpack('<I', buffer) # 错误！解析为 16777216 (0x01000000)字符串处理s 类型返回 bytes 对象，需用 .decode() 转为字符串：
data = struct.unpack('5s', b'Hello')[0]
print(data.decode('utf-8')) # 输出: 'Hello'内存对齐问题
默认格式 @ 会按本地对齐方式插入填充字节。使用 = 或标准顺序（</>）避免对齐。
五、常见错误
struct.error: unpack requires a buffer of X bytes
缓冲区长度与格式字符串不匹配。
- 解析指针类型 (
P)
结果依赖平台（32/64位），通常应避免使用。
通过合理设计格式字符串，struct.unpack() 可高效处理二进制协议（如网络数据、文件格式）。
到此这篇关于Python struct.unpack() 用法详解的文章就介绍到这了,更多相关Python struct.unpack() 用法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要介绍了Python lambda函数基本用法,结合实例较为详细的分析了Python lambda函数的功能、使用方法及相关操作注意事项,需要的朋友可以参考下2018-03-03
这篇文章主要介绍了用python制作游戏下载进度条的代码（程序说明见注释）,代码简单易懂，非常不错，具有一定的参考借鉴价值，需要的朋友可以参考下2019-10-10
这篇文章主要介绍了python redis 批量设置过期key过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2019-11-11
Python matplotlib 绘制双Y轴曲线图的示例代码
Matplotlib是非常强大的python画图工具，这篇文章主要介绍了Python matplotlib 绘制双Y轴曲线图,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2020-06-06
这篇文章主要介绍了Python字符串格式化%s%d%f详解，分享了相关代码示例，小编觉得还是挺不错的，具有一定借鉴价值，需要的朋友可以参考下2018-02-02
这篇文章主要为大家介绍了python实现滑动拼图验证码摆脱烦人的验证码输入方法详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-08-08
本文主要介绍了django redis的使用方法详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2023-04-04
这篇文章主要介绍了在Linux系统上安装Python的Scrapy框架的教程,Scrapy是著名的专门针对搜索引擎的爬虫制作而研发的Python框架,需要的朋友可以参考下2015-06-06
这篇文章主要介绍了Python打印斐波拉契数列的方法,实例分析了基于Python实现斐波那契数列的实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下2015-07-07
今天小编就为大家分享一篇浅谈Python中的异常和JSON读写数据的实现，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-02-02
最新评论