如何自动将C语言数值类型typedef导入Cython？

背景说明 #

假设你有一个config.h头文件，里面通过两种方式定义数值类型DTYPE_t：

方式1：typedef定义 #

// config.h
typedef int32_t DTYPE_t;

方式2：#define宏定义 #

// config.h
#define DTYPE_t int32_t

目前可以手动在Cython中复制类型定义，比如：

# my_cython_lib.pyx
from libc.stdint cimport int32_t
ctypedef int32_t DTYPE_t

DTYPE_t a = 1

但这种写法的问题很明显：一旦config.h里把DTYPE_t改成int64_t，就必须手动修改Cython代码，无法自动同步类型定义。

核心问题 #

如何不用显式声明数据类型或大小，直接将C层面通过typedef或#define定义的DTYPE_t导入Cython环境？你之前尝试的写法会报错：

cdef extern from "config.h":
    ctypedef DTYPE_t dtype_t # 错误：DTYPE_t 未定义

# 定义在`cdef extern from`块外
dtype_t a = 1

正确解决方法 #

针对typedef定义的DTYPE_t #

直接在cdef extern from块中导入该类型即可，Cython会自动读取头文件中的typedef定义，写法如下：

# my_cython_lib.pyx
# 先导入config.h依赖的标准类型（如果config.h用到了int32_t这类标准类型）
from libc.stdint cimport int32_t

cdef extern from "config.h":
    ctypedef DTYPE_t  # 直接导入C头文件中typedef定义的类型

# 直接使用DTYPE_t
DTYPE_t a = 1

这样，当config.h中的DTYPE_t类型变更时，Cython编译时会自动同步，无需手动修改pyx代码。

针对#define宏定义的DTYPE_t #

因为#define是C预处理宏，需要让Cython在编译阶段解析它，有两种实现方式：

方式一：在pyx文件中声明宏

# my_cython_lib.pyx
# 导入可能用到的基础类型
from libc.stdint cimport int32_t, int64_t

cdef extern from "config.h":
    DEF DTYPE_t  # 声明该宏定义

# 直接使用宏定义的类型
DTYPE_t a = 1

方式二：在编译配置中指定头文件

在setup.py中添加编译参数，确保预处理阶段能读取config.h：

# setup.py
from setuptools import setup
from Cython.Build import cythonize

setup(
    ext_modules=cythonize(
        "my_cython_lib.pyx",
        compiler_directives={"language_level": 3},
        extra_compile_args=["-I."]  # 假设config.h在当前项目根目录
    )
)

这样Cython编译时会自动解析config.h中的宏定义，替换DTYPE_t为对应的基础类型。

注意事项 #

• 如果config.h依赖其他头文件（比如stdint.h），需要确保编译环境能找到这些文件，必要时在setup.py的include_dirs参数中添加头文件路径。
• 宏定义的类型必须是Cython能识别的标准类型，否则需要额外处理类型映射。

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