Python struct.unpack() 用法及常見(jiàn)錯(cuò)誤詳解
struct.unpack() 是 Python 中用于將二進(jìn)制數(shù)據(jù)（字節(jié)序列）解析為 Python 數(shù)據(jù)類(lèi)型的函數(shù)，通常與 struct.pack() 配對(duì)使用。它根據(jù)指定的格式字符串（format string）解析字節(jié)流，并返回一個(gè)包含解析結(jié)果的元組。
一、函數(shù)語(yǔ)法
struct.unpack(format, buffer)
- format：格式字符串，定義數(shù)據(jù)的解析規(guī)則（字節(jié)順序、數(shù)據(jù)類(lèi)型、數(shù)量等）。
- buffer：包含二進(jìn)制數(shù)據(jù)的緩沖區(qū)（如
bytes、bytearray或支持緩沖協(xié)議的對(duì)象）。
返回值：包含解析后數(shù)據(jù)的元組。
二、格式字符串詳解
格式字符串由兩部分組成：
字節(jié)順序/對(duì)齊字符（可選）：
| 字符 | 含義 | 大小端 |
|---|---|---|
@ | 本地順序（默認(rèn)） | 系統(tǒng)依賴(lài) |
= | 本地標(biāo)準(zhǔn)大小 | 系統(tǒng)依賴(lài) |
< | 小端（Little-Endian） | 低位在前 |
> | 大端（Big-Endian） | 高位在前 |
! | 網(wǎng)絡(luò)順序（大端） | RFC 標(biāo)準(zhǔn) |
數(shù)據(jù)類(lèi)型字符（必選）：
| 字符 | C 類(lèi)型 | Python 類(lèi)型 | 字節(jié)數(shù) |
|---|---|---|---|
x | 填充字節(jié) | 跳過(guò)字節(jié) | 1 |
c | char | bytes (長(zhǎng)度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 | 長(zhǎng)度見(jiàn)下文 |
p | Pascal 字符串 | bytes | 1+長(zhǎng)度 |
P | void* | int | 系統(tǒng)依賴(lài) |
特殊用法：
特殊用法：
s：需指定長(zhǎng)度，如10s表示解析 10 字節(jié)的字符串。- 數(shù)字前綴：
3I表示連續(xù)解析 3 個(gè)無(wú)符號(hào)整數(shù)。
三、使用示例
示例 1：解析整數(shù)和浮點(diǎn)數(shù)
import struct
# 二進(jìn)制數(shù)據(jù)：小端順序 (<) + int (i) + float (f)
buffer = b'\x01\x00\x00\x00\xcd\xcc\x8c@'
data = struct.unpack('<if', buffer) # 解析1個(gè)int和1個(gè)float
print(data) # 輸出: (1, 7.000000476837158)示例 2：解析字符串
# 數(shù)據(jù)：大端 (>) + 4字節(jié)字符串 (4s)
buffer = b'ABCD'
data = struct.unpack('>4s', buffer)
print(data) # 輸出: (b'ABCD',)示例 3：解析混合類(lèi)型
# 數(shù)據(jù)：小端 (<) + short (h) + 3字節(jié)字符串 (3s) + float (f)
buffer = b'\x01\x00XYZ\x00\x00\x80?'
data = struct.unpack('<h3sf', buffer)
print(data) # 輸出: (1, b'XYZ', 1.0)示例 4：跳過(guò)填充字節(jié)
# 格式: 小端 (<) + char (c) + 填充1字節(jié) (x) + int (i)
buffer = b'A\x00\x02\x00\x00\x00'
data = struct.unpack('<cx i', buffer)
print(data) # 輸出: (b'A', 2)示例 5：解析數(shù)組
# 解析3個(gè)連續(xù)的 unsigned short (H)
buffer = b'\x01\x00\x02\x00\x03\x00'
data = struct.unpack('<3H', buffer)
print(data) # 輸出: (1, 2, 3)四、關(guān)鍵注意事項(xiàng)
緩沖區(qū)長(zhǎng)度必須匹配
使用 struct.calcsize(format) 驗(yàn)證格式字符串所需的字節(jié)數(shù)：
fmt = '<2i f' buffer = b'\x00' * struct.calcsize(fmt) # 創(chuàng)建匹配長(zhǎng)度的緩沖區(qū)
字節(jié)順序至關(guān)重要
大端/小端錯(cuò)誤會(huì)導(dǎo)致解析數(shù)值異常：
# 錯(cuò)誤示例：大端數(shù)據(jù)用小端解析
buffer = b'\x00\x00\x00\x01' # 大端表示的整數(shù) 1
struct.unpack('<I', buffer) # 錯(cuò)誤！解析為 16777216 (0x01000000)字符串處理s 類(lèi)型返回 bytes 對(duì)象，需用 .decode() 轉(zhuǎn)為字符串：
data = struct.unpack('5s', b'Hello')[0]
print(data.decode('utf-8')) # 輸出: 'Hello'內(nèi)存對(duì)齊問(wèn)題
默認(rèn)格式 @ 會(huì)按本地對(duì)齊方式插入填充字節(jié)。使用 = 或標(biāo)準(zhǔn)順序（</>）避免對(duì)齊。
五、常見(jiàn)錯(cuò)誤
struct.error: unpack requires a buffer of X bytes
緩沖區(qū)長(zhǎng)度與格式字符串不匹配。
- 解析指針類(lèi)型 (
P)
結(jié)果依賴(lài)平臺(tái)（32/64位），通常應(yīng)避免使用。
通過(guò)合理設(shè)計(jì)格式字符串，struct.unpack() 可高效處理二進(jìn)制協(xié)議（如網(wǎng)絡(luò)數(shù)據(jù)、文件格式）。
到此這篇關(guān)于Python struct.unpack() 用法詳解的文章就介紹到這了,更多相關(guān)Python struct.unpack() 用法內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
使用Django搭建網(wǎng)站實(shí)現(xiàn)商品分頁(yè)功能
這篇文章主要介紹了使用Django搭建網(wǎng)站實(shí)現(xiàn)商品分頁(yè)功能,文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-05-05
Flask的類(lèi)視圖提供了一種強(qiáng)大而靈活的方式來(lái)構(gòu)建Web應(yīng)用的業(yè)務(wù)邏輯,本文主要介紹了Flask類(lèi)視圖的基本用法及高級(jí)技巧,感興趣的可以了解一下2024-01-01
Python?函數(shù)參數(shù)11個(gè)案例分享
大家好，今天給大家分享一下明哥整理的一篇?Python?參數(shù)的內(nèi)容，內(nèi)容非常的干，全文通過(guò)案例的形式來(lái)理解知識(shí)點(diǎn)，自認(rèn)為比網(wǎng)上?80%?的文章講的都要明白，如果你是入門(mén)不久的?python?新手，相信本篇文章應(yīng)該對(duì)你會(huì)有不小的幫助,需要的朋友可以參考下2023-02-02
Python下載網(wǎng)絡(luò)小說(shuō)實(shí)例代碼
這篇文章主要介紹了Python下載網(wǎng)絡(luò)小說(shuō)實(shí)例代碼，分享了相關(guān)代碼示例，小編覺(jué)得還是挺不錯(cuò)的，具有一定借鑒價(jià)值，需要的朋友可以參考下2018-02-02
Python自動(dòng)化批量重命名與整理文件系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了如何使用Python實(shí)現(xiàn)一個(gè)強(qiáng)大的文件批量重命名與整理工具,幫助開(kāi)發(fā)者自動(dòng)化這一繁瑣過(guò)程,有需要的小伙伴可以了解下2025-07-07
Python實(shí)現(xiàn)手勢(shì)識(shí)別
這篇文章主要介紹了Python如何實(shí)現(xiàn)手指指尖的檢測(cè)，并且可以在windows系統(tǒng)下通過(guò)判斷手指數(shù)目，來(lái)模擬鍵盤(pán)操作，感興趣的朋友可以了解下2020-10-10
python的繼承知識(shí)點(diǎn)總結(jié)
在本文里小編整理的是關(guān)于python的繼承知識(shí)點(diǎn)總結(jié)內(nèi)容，學(xué)習(xí)到關(guān)于繼承的讀者們可以參考一下。2018-12-12
在前面學(xué)習(xí)了基本的打開(kāi)和建立文件之后，就可以對(duì)文件進(jìn)行多種多樣的操作了。請(qǐng)看官要注意，文件，不是什么特別的東西，就是一個(gè)對(duì)象，如同對(duì)待此前學(xué)習(xí)過(guò)的字符串、列表等一樣。2014-09-09
Python不通過(guò)調(diào)用init方法創(chuàng)建實(shí)例的完整指南
在Python面向?qū)ο缶幊讨?__init__方法被視為標(biāo)準(zhǔn)的對(duì)象初始化機(jī)制,本文將深入探討不調(diào)用__init__方法創(chuàng)建實(shí)例的各種技術(shù),希望對(duì)大家有所幫助2025-10-10
這篇文章主要介紹了python異常處理、自定義異常、斷言,結(jié)合實(shí)例形式分析了python異常處理、自定義異常、斷言相關(guān)概念、原理、用法及操作注意事項(xiàng),需要的朋友可以參考下2020-03-03