要使用 Cython 将 Python 代码编译为 `.pyd` 文件（Windows 下的 Python 扩展模块），需要完成以下步骤： ### 准备工作 1. **安装 Cython**： 确保已经安装了 Cython，可以使用 pip 进行安装： ```bash pip install cython ``` 2. **准备 `.pyx` 文件**： Cython 的源文件扩展名为 `.pyx`。如果你有一个 `.py` 文件，可以将其重命名为 `.pyx`，或者直接编写 `.pyx` 文件。 3. **创建 `setup.py` 文件**： 使用 `distutils` 或 `setuptools` 来编译 Cython 代码。创建一个 `setup.py` 文件，内容如下： ```python from setuptools import setup from Cython.Build import cythonize setup( name='MyModule', ext_modules=cythonize("myfile.pyx", compiler_directives={'language_level': "3"}), ) ``` ### 编译步骤 1. **运行编译命令**： 在命令行中运行以下命令来编译 `.pyx` 文件： ```bash python setup.py build_ext --inplace ``` 这将生成一个与平台相关的 `.pyd` 文件（在 Windows 上）或 `.so` 文件（在 Linux 或 macOS 上）。 2. **检查生成的 `.pyd` 文件**： 编译完成后，会在当前目录下生成一个 `.pyd` 文件。例如，如果 `myfile.pyx` 是源文件，则生成的文件可能是 `myfile.cp39-win_amd64.pyd`（具体名称取决于 Python 版本和平台）。 ### 验证是否成功 1. **导入模块**： 在 Python 中导入生成的模块，验证是否能够正常运行： ```python import myfile myfile.myfunction() ``` 2. **检查是否通过 Cython 运行**： 如果代码中包含性能敏感部分，可以通过运行时间或调试信息判断是否通过 Cython 编译执行。此外，可以添加一些调试输出来确认代码是否运行在 Cython 环境中。 ### 注意事项 - **Python 版本兼容性**： 确保编译时使用的 Python 版本与目标环境一致。不同版本的 Python 生成的 `.pyd` 文件可能不兼容 [^2]。 - **Windows 特定问题**： 在 Windows 上，`.pyd` 文件本质上是一个 DLL 文件，必须确保 Python 能够正确加载它。路径问题或依赖项缺失可能导致导入失败 [^3]。 - **Maya 环境中的 `.pyd` 文件**： 如果在 Maya 等特定环境中使用 `.pyd` 文件，需要确保编译时使用的 Python 版本与 Maya 内部集成的 Python 版本一致 [^4]。 - **C++ 支持**： 如果使用了 C++ 代码（例如通过 `cdef extern` 调用 C++ 库），可以在 `setup.py` 中指定语言为 C++： ```python from setuptools import Extension from setuptools import setup from Cython.Build import cythonize extensions = [ Extension("myfile", ["myfile.pyx"], language="c++") ] setup( name='MyModule', ext_modules=cythonize(extensions, compiler_directives={'language_level': "3"}), ) ``` - **GPU 支持**： 如果项目中包含 CUDA 代码（`.cu` 文件），需要额外配置 `setup.py` 以支持 CUDA 编译 [^5]。 ### 示例代码 假设有一个简单的 `.pyx` 文件 `myfile.pyx`： ```python def myfunction(): print("Hello from Cython!") ``` 编译完成后，生成的 `.pyd` 文件可以在 Python 中直接导入并运行。