如何在不修改test.c的前提下解决Python ctypes结构体数组交互问题？

1. 修复类名冲突问题 #

你自定义的ctypes结构体别用complex当类名——Python内置了同名的复数类型，重名会导致后续数组索引操作触发TypeError。改成ComplexStruct这类不会冲突的名字即可。

2. 严格匹配C结构体的内存布局 #

假设你的C结构体定义如下：

// test.h
typedef struct {
    float Re;
    float Im;
} complex;

Python里对应的结构体要精准匹配字段名和类型，否则会出现数值异常：

import ctypes

class ComplexStruct(ctypes.Structure):
    _fields_ = [
        ("Re", ctypes.c_float),
        ("Im", ctypes.c_float)
    ]

如果C里用的是double类型，Python要同步改成ctypes.c_double，类型必须严格对应。

3. 正确创建数组并调用C函数 #

假设C函数签名为：

void test(complex* arr, int length);

Python侧按以下方式调用：

# 加载编译好的动态库（Windows用test.dll，Linux/macOS用libtest.so）
lib = ctypes.CDLL("./libtest.so")

# 声明函数参数类型，避免ctypes自动转换出错
lib.test.argtypes = [ctypes.POINTER(ComplexStruct), ctypes.c_int]
lib.test.restype = None

# 创建指定长度的结构体数组
arr_len = 3
myarray = (ComplexStruct * arr_len)()

# 初始化数组元素
myarray[0].Re = 1.0
myarray[0].Im = 2.0
myarray[1].Re = 3.0
myarray[1].Im = 4.0

# 调用C函数修改数组
lib.test(myarray, arr_len)

# 正常访问数组元素
print(f"第一个元素：Re={myarray[0].Re}, Im={myarray[0].Im}")

额外排查点 #

• 确保Python和编译的C动态库位数一致（都是32位或64位），内存对齐错误会引发数值异常。
• 如果C函数里有内存操作，确认没有越界访问数组。

内容的提问来源于stack exchange，提问作者Dana Kim