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 年 1 月 20 日

関連ページ：

型レンダリングを構成する

デバッグセッション中、PyCharm は変数、型、スレッド、フレームなどの情報を表示します。ただし、特定のランタイムの詳細に焦点を当て、データをフィルター処理したり、特定の形式でレンダリングしたりすることもできます。このシナリオでは、PyCharm を使用すると、デバッガーの出力がデバッグツールウィンドウとエディターに表示される方法をカスタマイズできます。型レンダラーは、Python コンソールおよび Jupyter 変数ビューでも使用されます。カスタム型レンダラー：PyCharm を使用すると...

リモート PyCharm によるデバッグ

PyCharm を使用すると、Web サーバーや専用のテストマシンなど、他のコンピューターにあるインタープリターを使用してアプリケーションをデバッグすることができます。PyCharm には、リモートでデバッグする 2 つの方法があります。リモートインタープリターを経由します。大 / 小文字: リモートマシンで利用可能な拡張デバッグ機能を利用するためにこのアプローチを使います。要件: ローカルマシンからリモートサーバーへの SSH アクセス。Python リモートデバッグサーバー設定を使用します。大...