如何在Python中使用struct模块打包与解析C语言结构体

阿芳吖_3791

阿芳吖_3791

2026-09-08

663人浏览

原创

struct.pack()需显式指定字节序并校验大小,紧凑结构用"pack(1)"对应"bhi"等格式,字符串手动补零,数组需分段解析而非整块unpack。

如何在python中使用struct模块打包与解析c语言结构体

struct.pack() 打包时字节序和格式符必须严格匹配C结构体定义

Python struct.pack() 不会自动适配C编译器的默认对齐或字节序,直接按 "iif" 这类格式打包,很可能和C端 struct { int a; int b; float c; } 实际内存布局不一致——尤其在跨平台(如x86_64 Linux vs ARM macOS)或混合使用 #pragma pack 时。

实操建议:

  • 始终显式指定字节序:"(小端)、<code>">"(大端)、"!"(网络序),避免依赖系统默认的 "@"(本机序)
  • struct.calcsize() 核对长度是否与C中 sizeof(struct my_s) 一致,不一致就说明对齐或填充有问题
  • 若C结构体含 #pragma pack(1),Python端必须用紧凑格式符(如 "BHI" 而非 "BHi"),否则 struct 会按默认对齐插入填充字节
  • 字符串字段要手动补 \x00 并截断,struct 不处理C风格空终止字符串

解析C结构体数组时不能直接用 struct.unpack() 处理整个二进制块

遇到C端传来的 struct record arr[10] 数组,常见错误是把整块 bytes 直接喂给 struct.unpack(),结果报 struct.error: unpack requires a buffer of 40 bytes(但实际给了400字节)——因为 unpack() 只解一个结构体,不是循环解析。

正确做法是分段提取:

  • 先用 struct.calcsize(fmt) 算单个结构体长度,比如 sz = struct.calcsize("<ifi></ifi>
  • 再用 [i*sz:(i+1)*sz] 切片,配合 struct.unpack_from(fmt, data, offset) 逐个解析
  • 若数据来自 socket 或 mmap,优先用 unpack_from 避免反复拷贝子串
  • 注意:C数组在内存中是连续平铺的,没有额外分隔符或长度头,Python端必须预先知道元素个数

处理C结构体中的指针或柔性数组成员(FAM)需绕过 struct 模块

struct 模块完全无法表示C中的指针(如 char *name)或柔性数组(如 int data[]),它只处理固定长度的二进制布局。强行用 "P" 格式符不仅不可移植(P 是本机指针大小,且值无意义),还会在跨进程/序列化时彻底失效。

python-docx
python-docx

python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能,主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践;生成安全服务方案文档;核心要点生成技术架构设计文档;生成任何需要专业排版的Word文档;核心库 : python-docx;使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns;标准代码模板;1. 文档初始化;2. 字体设置(必须!它将相关步骤、工具调用和结果整理方式集

下载

真实场景应对方式:

  • 指针字段应被替换为“内联数据 + 长度字段”,例如C端改用 uint32_t name_len; char name[64];,Python用 "I64s" 解,再用 .rstrip(b"\x00").decode()
  • 柔性数组必须配合显式长度字段:C结构体加 uint32_t payload_size;,Python先解头部,再按该值切出后续 payload bytes
  • 若必须对接遗留C接口且含指针,只能用 ctypes 定义完整结构体类,再通过 from_buffer_copy() 映射——但要求内存布局100%可控

struct.unpack() 报错 "unpack str size" 通常是字节长度或格式符不匹配

典型错误信息:struct.error: unpack requires a buffer of 24 bytes,但你传了23或25字节。这不是随机错误,而是 struct 在校验输入长度时发现和格式符预估长度对不上。

排查步骤:

  • 立即运行 struct.calcsize("你的格式符"),确认输出是否等于你传入 bytes 的 len(data)
  • 检查是否误用了 "s"(字节串)而非 "p"(Pascal字符串);"4s" 总是读4字节,哪怕内容含 \x00
  • Windows上用 "f" 解C的 float 没问题,但解 double 必须用 "d",用错会差4字节
  • 调试时可先用 list(data) 打印十六进制字节流,对照C端 printf("%02x ", ((unsigned char*)&s)[i]) 输出逐字节比对

最易被忽略的是C结构体里的位域(bit-field)和联合体(union)——struct 模块根本不支持,必须拆成整数字段后手动位运算还原。这点没有绕过办法,得提前和C端约定放弃位域,或改用 ctypes

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1531

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3604

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1549

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

20517

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2547

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2607

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1063

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2023

5

热门下载

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

精品课程

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