如何在Python中调用C++生成的DLL（仅有.h头文件无.cpp文件）

你手头有可正常工作的C# P/Invoke包装、DLL文件和对应头文件，不需要C++源码即可完成绑定，核心逻辑和C# P/Invoke完全对等——都是手动对齐类型、调用约定后直接调用DLL导出函数，推荐优先用Python原生的ctypes实现，步骤如下：

1. 先对齐基础调用规则 #

• 直接参考现有.cs文件的DllImport配置是效率最高的方式，不需要从头啃头文件：重点记清楚每个函数的入口名、调用约定（Cdecl/StdCall）、参数类型、返回值类型、结构体对齐配置。
• 如果需要从头文件核对：注意C默认会对函数名做名称粉碎，如果函数声明带extern "C"修饰，可以直接用函数名定位导出入口；如果是纯C导出没有extern "C"，用VS自带的dumpbin /exports 你的dll路径命令查看实际导出的粉碎名，和C#配置里的EntryPoint字段对齐即可。
• 调用约定必须完全匹配：C#里配置为Cdecl的，Python用CDLL加载DLL；配置为StdCall的，用WinDLL加载DLL，约定不匹配会直接触发栈溢出崩溃。

2. 复现所有自定义类型 #

对照.h头文件和C#的结构体定义，用ctypes的类型系统一比一复刻所有自定义结构体、枚举、联合体，核心保证字段顺序、类型长度、内存对齐规则完全一致：

• C#里StructLayout标注的Pack值，直接对应Python结构体类的_pack_属性，默认值为8，对齐值错误会导致所有字段读值错乱。
• 基础类型直接按长度映射即可：int对应c_int、double对应c_double、char*对应c_char_p、wchar_t*对应c_wchar_p、void*对应c_void_p、定长字符数组对应c_char * 数组长度、指针/引用参数对应POINTER(目标类型)。
• 示例：头文件中定义如下结构体

#pragma pack(4)
struct DeviceInfo {
    int deviceId;
    float temperature;
    char serialNum[24];
};

对应的Python定义为

from ctypes import *

class DeviceInfo(Structure):
    _pack_ = 4
    _fields_ = [
        ("deviceId", c_int),
        ("temperature", c_float),
        ("serialNum", c_char * 24)
    ]

• C#里的委托对应Python里的CFUNCTYPE（Cdecl约定）或WINFUNCTYPE（StdCall约定）定义的函数指针类型。

3. 绑定导出函数 #

加载DLL后逐个绑定导出函数，必须显式声明每个函数的参数类型列表argtypes和返回值类型restype，未声明的情况下ctypes会默认按int类型处理参数，极易出现参数错位、内存访问崩溃。
示例：对应C#的导入声明

[DllImport("device.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern int GetDeviceInfo(int deviceId, ref DeviceInfo outInfo);

对应的Python绑定代码为

# 加载DLL
device_dll = CDLL("./device.dll")
# 绑定函数
get_device_info = device_dll.GetDeviceInfo
get_device_info.argtypes = [c_int, POINTER(DeviceInfo)]
get_device_info.restype = c_int

4. 调用与避坑要点 #

• 参数传递规则：值类型直接传实例，指针/引用类型传byref(实例)或pointer(实例)，和C#里加ref/out的传参逻辑对齐。
• 内存管理：所有DLL内部申请的内存，必须调用DLL提供的对应释放接口释放，禁止直接在Python侧释放内存，和C#的内存管理逻辑完全一致。
• 字符串处理：传char*类型参数时，要先把Python字符串按DLL要求的编码（通常是gbk或utf8）encode为bytes类型再传入，避免编码乱码。
• 回调函数：传入DLL的Python回调对象必须持有全局引用，避免被Python GC回收后触发野指针崩溃，和C#里把委托存为类成员保活的逻辑一致。

复杂场景备选 #

如果DLL里包含大量C++类、重载函数、模板类型，手写ctypes绑定成本过高，可以换用cffi库，支持直接解析.h头文件自动生成类型定义，大幅减少手写代码量，核心的调用约定对齐、内存管理规则和ctypes完全一致。

不建议手动解析C类虚表、调整this指针传参来直接调用C类成员函数，出错概率极高，优先对照已经验证可用的C#包装器一比一复刻签名是最稳妥的方案。

内容的提问来源于stack exchange，提问作者Алихан Хасиев