Python使用ctypes调用C/C++ DLL详解与结构体处理技巧

Alice

发布时间：2026-10-15 | 4人浏览过

原创

本文详解Python如何通过内置ctypes模块调用C/C++生成的DLL文件。重点讲解从加载DLL、类型转换到结构体嵌套传输的完整流程，并针对大结构体数据错误问题，提供基于#pragma pack和_pack_参数的内存对齐解决方案，确保C/C++与Python间数据交互的准确性。

ctypes模块基础与调用流程

在Python与C/C++混合编程场景中，官方推荐采用Python内置模块ctypes。尽管该模块名称源自C语言，表明其对C++特性的原生支持相对有限，但通过合理配置仍可实现有效交互。

实现调用的标准流程通常包含以下关键步骤：

首先，导入ctypes模块并将C/C++生成的DLL加载至Python进程空间。
其次，将Python内置数据类型映射并转换为ctypes对应的类型。
最后，确保ctypes类型能正确转换为C/C++端可识别的类型格式。

关于ctypes的具体用法与规范，可参考官方文档获取详细信息。

开发环境配置

本教程基于VS2017开发环境及Python3.8版本，使用PyCharm作为集成开发环境进行演示。

基本类型与结构体通信示例

基本数据类型及简单结构体类型均能实现正常通信。以下为C/C++端DLL的代码示例：

extern "C"{

struct MyStruct{
int num_int;
long num_long;
float num_float;
double num_double;
char* num_str;
};

int __declspec(dllexport) print(MyStruct my)
printf("%d\n", my.num_int);
printf("%d\n", my.num_long);
printf("%f\n", my.num_float);
printf("%f\n", my.num_double);
printf("%s\n", my.num_str);
}

对应Python端的调用代码如下：

import ctypes

class MyStruct(Structure):
_fields_ = [
("num_int", c_int),
("num_long", c_long),
("num_float", c_float),
("num_double", c_double),
("num_str", c_char_p)
]

# dll全路径，依赖完整
dll = ctypes.WinDLL("C:\\work\\mytest.dll")

#调用
my = MyStruct();
my.num_int = 23
my.num_long = 1024
my.num_float = 3.14
my.num_double = 3.141592653
my.num_str = b"hello world"
dll.print(my)

复杂结构体传输与内存对齐优化

即便涉及结构体嵌套，传输通常也能成功。然而，在大型项目中处理大结构体时，可能会遭遇数据通信错误，例如char*指针在传递至C/C++端时变为无效字符。建议调整结构体成员定义顺序，遵循先简单后复杂的排列原则。此外，务必参考官方文档，确保Python与C/C++中的结构体定义在字节对齐上保持一致。

具体示例如下：

<strong>#pragma pack(4)</strong>
struct MyStruct{
int num_int;
long num_long;
float num_float;
double num_double;
char* num_str;
};

class MyStruct(Structure):
<strong>_pack_ </strong><strong>= 4</strong>
_fields_ = [
("num_int", c_int),
("num_long", c_long),
("num_float", c_float),
("num_double", c_double),
("num_str", c_char_p)
]

至此，关于Python使用ctypes调用C/C++ DLL的详细内容已介绍完毕。如需了解更多相关技术，建议查阅本站过往文章或继续浏览后续内容，感谢大家的支持。