Cython 加速

安装 Python 扩展

PyCharm 的调试器使用 Python 编写。 Python 是一种解释型语言，这意味着指令必须在代码运行时被翻译为机器代码。

这会耗费时间，因此其速度不及已编译的代码。所幸，Python 通过 Cython 支持已编译的 C 扩展。 PyCharm 随附了调试器代码的 C 版本，您可以将其编译，以加快在 PyCharm 中的调试。

如果您的代码库很大，使用此加速扩展是合理的。

获取额外加速所需的操作取决于您的平台：

类 UNIX: 当用户启动调试器会话时，会出现通知弹窗。用户只需点击其中的安装链接：
如果在点击安装链接后仍反复收到相同的弹窗通知，请检查您对 PyCharm 使用的目录的权限。要安装 Cython 扩展，您必须具有写入权限。
macOS 和 Windows: 您无需执行任何操作。我们已捆绑预编译的扩展，因此您已经在使用它们。

已报告的问题	可能原因	解决方案
显示以下错误消息： `Python.h: no such file or directory`。	缺少 Python 的头文件和静态库。	使用您的包管理器在系统范围内安装 `python-dev` 软件包。在 Linux 上，您可以运行以下命令： sudo apt-get install python-dev 要为特定的 Python 版本安装该软件包，请使用 `python-dev<version>`。例如： sudo apt-get install python3.11-dev
显示以下错误消息： `Command 'gcc' failed with exit status 1`。	缺少 C 编译器。	请安装 C 编译器，以便为调试器构建 Cython 扩展。有关更多信息，请参阅 Cython 文档。

已报告的问题

可能原因

解决方案

显示以下错误消息：

Python.h: no such file or directory。

缺少 Python 的头文件和静态库。

使用您的包管理器在系统范围内安装 python-dev 软件包。

在 Linux 上，您可以运行以下命令：

sudo apt-get install python-dev

要为特定的 Python 版本安装该软件包，请使用 python-dev<version>。例如：

sudo apt-get install python3.11-dev

显示以下错误消息：

Command 'gcc' failed with exit status 1。

缺少 C 编译器。

请安装 C 编译器，以便为调试器构建 Cython 扩展。有关更多信息，请参阅 Cython 文档。

如果您希望手动编译 Cython 加速，请不要使用 PyCharm UI。

在 Ubuntu 上，请使用以下命令：

            /usr/bin/python3 /<PYCHARM_INSTALLATION_PATH>/plugins/python-ce/helpers/pydev/setup_cython.py build_ext --inplace
        
  

其中 <PYCHARM_INSTALLATION_PATH> 是本地 PyCharm 安装目录的路径，例如 /opt/pycharm-2025.3。

2026年 3月 24日