PyCharm 2025.3 Help

Cython 加速

安装 Python 扩展

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

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

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

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

类 UNIX

当用户启动调试器会话时,会出现通知弹窗。 用户只需点击其中的 安装 链接:

安装 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 文档

在不使用 PyCharm UI 的情况下使用 Cython 加速

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

在 Ubuntu 上,请使用以下命令:

~/.cache/JetBrains/RemoteDev/dist/<unique_id>_pycharm-2025.2.x-<architecture>/plugins/python-ce/helpers/pydev/setup_cython.py

<PYCHARM_INSTALLATION_PATH> 是 PyCharm 安装目录的路径,例如 /opt/pycharm-2022.1

请注意,应根据您的本地系统调整路径。

最后修改日期: 2025年 12月 2日