如何正确将.py转为.pyd？解决导入失败、符号缺失问题

问题场景 #

我有一个位于core_app\functions\my_function.py的Python文件，代码如下：

from typing import Optional
from core_app.routes.models import (Model1, Model2, Model3)
from core_app.routes.utils import(method1, method2)
from core_app.exceptions import custom_exception1, custom_exception2

SOME_CONSTANT = "some constant"

async def function1(model1: Model1, param1: str, param2: str) -> Model2:
      .................

async def function2(model1: Model1, param1: str, param2: str, param3: str) -> Model3:
    .....................

def function3(param1: str) -> Model1:
     ................

希望将其转换为包含所有符号（常量、函数）的.pyd文件，移除原.py文件后仍可正常使用。编写的setup.py如下：

setup(
    ext_modules=cythonize(
        extensions,
        compiler_directives={"language_level": "3", "emit_code_comments": False}
    ),
    cmdclass={'build_ext': CustomBuildExt},
    zip_safe=False,
)

生成.pyd文件后，执行from core_app.functions.my_function import function3导入失败，用dumpbin工具检查发现function3等方法的符号不存在。

解决步骤 #

1. 完善setup.py的Extension配置 #

你的setup.py中缺失extensions变量的定义，这是Cython编译的核心配置项。补充完整的配置示例：

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

# 定义扩展模块，需与原Python模块路径完全匹配
extensions = [
    Extension(
        "core_app.functions.my_function",
        sources=["core_app/functions/my_function.py"],
        extra_compile_args=["/O2"]  # Windows编译优化参数，Linux替换为["-O2"]
    )
]

# 若CustomBuildExt无特殊逻辑，可直接删除该类及cmdclass参数
class CustomBuildExt:
    pass

setup(
    ext_modules=cythonize(
        extensions,
        compiler_directives={"language_level": "3.7", "emit_code_comments": False}
    ),
    cmdclass={'build_ext': CustomBuildExt},
    zip_safe=False,
)

注意：异步函数需要language_level设置为3.7及以上，确保Cython支持async语法。

2. 显式标记需导出的符号 #

Cython默认不会自动导出所有Python级函数/常量到扩展符号表，需手动指定：

方式一：批量导出所有符号

在my_function.py顶部添加Cython指令注释：

# cython: export_all=True
from typing import Optional
# ... 其余原有代码不变

export_all=True会强制导出所有顶级函数、常量到模块符号表。

方式二：精确导出指定符号

若只需导出部分符号，可添加__pyx_extern__声明：

from typing import Optional
# ... 原有导入语句

# 声明需要导出的符号
__pyx_extern__ = """
SOME_CONSTANT
function1
function2
function3
"""

SOME_CONSTANT = "some constant"
# ... 其余原有代码不变

3. 重新编译生成.pyd文件 #

执行编译命令：

python setup.py build_ext --inplace

编译完成后，将生成的带版本后缀的.pyd文件（如my_function.cp310-win_amd64.pyd）重命名为my_function.pyd，确保与原模块名一致，然后删除原my_function.py和.pyc文件。

4. 验证导入 #

执行导入测试：

from core_app.functions.my_function import function3, SOME_CONSTANT

此时dumpbin工具应能在.pyd文件中查到对应符号。

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