导入Cython模块时出错：C函数签名不匹配

问题根源 #

你遇到的错误是因为Cython将同一个结构体A识别成了两个独立的C类型：

• __pyx_t_3cfr_1a_A：来自cfr.a模块的外部接口类型
• __pyx_t_1a_A：来自a.pyx里不完整定义的内部类型

核心问题有两点：

• a.pyx中的A结构体定义和a.pxd的公共接口不一致，仅写pass会让Cython生成与接口不匹配的内部类型
• 包结构下的模块依赖未被Cython正确解析，导致类型命名空间冲突

解决方案 #

1. 同步.pxd与.pyx的结构体定义 #

.pxd是对外暴露的公共接口，.pyx中的实现必须完全匹配该接口，不能省略字段：

修改后的a.pyx：

cdef struct A:
    int a  # 与a.pxd中的定义完全一致

cdef A makeA(int a):
    cdef A sA
    sA.a = a
    return sA

2. 正确配置包编译脚本 #

假设项目目录结构为：

cfr/
├── __init__.py
├── a.pxd
├── a.pyx
└── b.pyx

编写setup.py明确模块依赖，让Cython正确识别内部接口：

setup.py示例：

from setuptools import setup, Extension
from Cython.Build import cythonize

extensions = [
    Extension(
        "cfr.a",
        ["cfr/a.pyx"]
    ),
    Extension(
        "cfr.b",
        ["cfr/b.pyx"],
        depends=["cfr/a.pxd"]  # 声明b依赖a的接口文件
    )
]

setup(
    name="cfr",
    ext_modules=cythonize(extensions),
    packages=["cfr"]
)

3. 保持导入路径一致性 #

b.pyx的导入写法无需修改，确保编译时Cython能找到cfr.a的接口即可：

from cfr.a cimport A, makeA

cdef int get_A_value():
    cdef A sA = makeA(5)
    return sA.a 

编译与验证 #

执行编译命令：

python setup.py build_ext --inplace

编译完成后，在Jupyter Lab中导入cfr.b模块即可正常运行，不会再出现签名不匹配错误。

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