PyCharm 2025.2 Help

Cython 支持

先决条件

PyCharm 开箱即提供初始的 Cython 支持。 PyCharm 识别 .pyx .pxd .pxi 文件,并允许您编辑它们。 您还可以使用 Cython 包将这些文件在 Unix 和 macOS 上编译为 .so 文件,或在 Windows 上编译为 .pyd 文件。

Cython 支持

Cython 文件以 cython 图标标记。

Cython 支持包括:

  • 代码辅助:

  • 代码检查。 几乎所有的 Python 代码检查都适用于 Cython。

  • 重构

  • 通过源代码的智能搜索,特别是 查找用法

  • 编译 Cython 模块:

    • 编译是通过 外部工具 完成的。 首选的构建系统( Makefile setup.py 等)应 配置为外部工具

    • 需要在您的计算机上下载并安装 C 编译器

在 PyCharm 中开始使用 Cython

请按照此流程在 PyCharm 中创建 .pyx 文件,进行编辑,并使用 setup.py 将其构建为 .so 文件(Windows 上为 .pyd 文件)。

  1. 按照 创建一个 Python 项目 中的说明创建一个新项目。

  2. 请确保已使用 Python 解释器安装 Cython 包(设置 | Python | 解释器)。 有关安装包的更多信息,请参阅 安装、卸载和升级软件包

  3. 现在创建一个 .pyx 文件。 从主菜单中选择 新建文件 ,然后选择 文件。 输入文件名,例如 example.pyx 并保存更改。 文件将在编辑器中打开。

  4. 您可以复制并粘贴以下代码:

    def function (a: int, b: int) -> str: return str(a + b) function(2, 4)
  5. 现在创建 setup.py 文件。 从主菜单中选择 工具 | 创建 setup.py。 PyCharm 创建一个模板 setup.py 文件并在编辑器中打开它。 您可以复制并粘贴以下设置选项:

    from setuptools import setup, Extension module = Extension ('example', sources=['example.pyx']) setup( name='cythonTest', version='1.0', author='jetbrains', ext_modules=[module] )
  6. 要编译 example.pyx 文件,请从主菜单中选择 工具 | 运行 setup.py 任务 命令。 在 输入 setup.py 任务名称 中输入 build 并选择 扩展构建 任务。 欲了解更多信息,请参阅 创建并运行 setup.py

    选择构建任务

    运行设置任务扩展构建 对话框中,添加 --inplace 命令行参数

    添加命令行参数

    构建任务成功完成后,将创建 .so 文件(Windows 上为 .pyd 文件)。

    使用构建任务进行编译

此时,您可以使用编译后的文件导入 function

from example import function

请参阅 Cython 文档 以获取完整说明。

最后修改日期: 2025年 9月 26日