Cython のスピードアップ

Python 拡張機能のインストール

PyCharm のデバッガーは Python で書かれています。 Python はインタープリター方式の言語であり、実行時に命令がマシンコードへ変換される必要があります。

これは時間がかかります。そのため、コンパイル済みコードほど高速ではありません。幸いにも、Python は Cython を通じてコンパイル済み C 拡張をサポートしています。 PyCharm には C バージョンのデバッガーコードが付属しており、これをコンパイルすることで PyCharm でのデバッグが高速になります。

コードベースが大きい場合は、この高速化拡張機能を使用するのが妥当です。

追加のスピードアップを得るために必要なアクションは、プラットフォームによって異なります。

*NIX: ユーザーがデバッガーセッションを開始すると、通知ポップアップが表示されます。ユーザーはそこにあるインストールするリンクをクリックするだけです。
インストールするリンクをクリックした後、同じポップアップ通知が繰り返し表示される場合は、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 コンパイラーが不足しています。	デバッガー用の Cython 拡張機能をビルドするために、C コンパイラーをインストールします。詳細については、 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 コンパイラーが不足しています。

デバッガー用の Cython 拡張機能をビルドするために、C コンパイラーをインストールします。詳細については、 Cython のドキュメント(英語)を参照してください。

PyCharm UI なしで 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 年 6 月 1 日