PyCharm のトラブルシューティング
PyCharm を使用していると、警告メッセージやエラーメッセージが表示されることがあります。 この章では、既知の問題の解決策と回避策の一覧を示します。
また、作業環境のトラブルシューティングと基本的な診断を行うための推奨事項を見つけることもできます。
報告された問題 | 考えられる原因 | ソリューション |
|---|---|---|
プロジェクト設定 | ||
Python インタープリターは、 で使用可能なインタープリターのリストでサポートされていないものとしてマークされています。 | マークされたインタープリターの Python バージョンは古く、PyCharm ではサポートされていません。 | サポートされていないインタープリターを使用可能なインタープリターのリストから削除できます。 サポートされている Python バージョンの詳細については、「Python サポート 」を参照してください。 |
コード編集 | ||
PyCharm エディターはコードの編集を制限します。 | IdeaVim プラグインをインストールして、vim 編集モードを有効にしました。 | メニューの Vim エミュレーター を選択解除します。 詳しくは PyCharm での Vim エディターエミュレーションの使用を参照してください。 |
Python コードはエディターでハイライトされません。 | PY ファイルは、テキストファイル形式に関連付けられています。 | 設定 ダイアログ (Ctrl+Alt+S) で、 に移動し、 認識されたファイルの種類 リストから テキストを選択し、 ファイル名のパターン リストから *.py を選択して、 |
コード補完 | ||
コード補完アクションは使用できません。 | 省電力モードが有効になります。 | メインメニューから ファイル を選択し、 省電力モード チェックボックスをオフにします。 |
ファイルがコンテンツルートに存在しないため、コード補完に必要なクラス定義とリソースを取得できません。 | ソースファイルを再構成します。 | |
補完候補リストに表示するクラスと関数を含むファイルはプレーンテキストファイルです。 | ソースファイルのフォーマットを再考し、必要に応じて変更します。 | |
デバッグ | ||
Docker の実行/デバッグ構成をデバッグできません。 デバッグ アクションは利用できません。 | PyCharm は、Python の実行 / デバッグ構成のデバッグを提供します。 | Docker ベースのインタープリターを構成し、 Docker コンテナーで Python スクリプトをデバッグします。 |
Python デバッガーは、Gevent コードをデバッグするときにハングします。 | Gevent 互換モードは有効になっていません。 | 設定 ダイアログ (Ctrl+Alt+S) で、 に移動し、 Gevent 互換 チェックボックスを選択します。 |
いくつかのインポートエラーが PyQt コードで報告されます。 | PyQt はインタープリターにインストールされますが、アプリケーションコードにインポートされません。 | 設定 ダイアログ (Ctrl+Alt+S) で、 に移動し、の PyQt 互換 チェックボックスをオフにします。 このモードはデフォルトで有効になっています。 |
デバッグプロセスが遅いです。 | デバッガーは、例外が発生してプロセスが終了したときだけでなく、例外がスローされたとき（プロセスが終了してもプロセスの終了に至らなかった場合でも）に停止します。 | ブレークポイント ダイアログ（ ）の raise 時 チェックボックスをクリアします。 |
次のエラーメッセージは、ローカルプロセスへの最初の接続試行時に表示されます: | これは Ubuntu の 既知の問題(英語)です。 |
|
Cython のスピードアップ | ||
次のエラーメッセージが表示されます。
| Python のヘッダーファイルと静的ライブラリが不足しています。 | パッケージマネージャーを使用して、 Linux では、次のコマンドを実行できます。
sudo apt-get install python-dev
特定の Python バージョンのパッケージをインストールするには、
sudo apt-get install python3.11-dev
|
次のエラーメッセージが表示されます。
| C コンパイラーが不足しています。 | デバッガー用の Cython 拡張機能をビルドするために、C コンパイラーをインストールします。 詳細については、 Cython のドキュメント(英語)を参照してください。 |
Cython スピードアップ拡張機能の通知で インストールする リンクをクリックしましたが、PyCharm は繰り返しインストールを求めます。 | PyCharm が使用するディレクトリに書き込む権限がありません。 | 権限を確認して変更してください。 |
パッケージング | ||
パッケージのインストールが失敗します。 | pip は、特定の Python インタープリターでは使用できないか、インストール要件のいずれかが満たされていません。 |
|
Docker (Docker のトラブルシューティング を参照) | ||
File Watchers ウィンドウに次のメッセージが表示される場合があります。 | ||
| ファイルウォッチャーは、このプロジェクトで定義されていないスコープを使用します。 | ウォッチャーをダブルクリックして、使用可能なスコープを選択するか、新しいスコープを作成します。 |
| このプロジェクトは、削除されたグローバル File Watcher を使用します。 | 削除 ボタン |
デプロイ | ||
SSH 設定使用時のエラーメッセージ:
| OpenSSH キーの RFC4716 形式は、PyCharm ではサポートされていません。 |
|
プロファイル コマンドは、 実行 メニューでは使用できません。 |
| PyCharm のエディションを確認し、 ダイアグラム プラグインを プラグイン設定で有効にしてください。 |
をクリックします。場合によっては、PyCharm または作業環境で問題が発生しているかどうかを識別する診断手順を実行する必要があります。 以下は便利なヒントの一覧です。
トラブルシューティングのケース | 診断処置 |
|---|---|
PyCharm およびターミナルウィンドウでアプリケーションを実行すると、アプリケーションの動作が異なることがあります。 | PyCharm プロジェクト設定で指定された python バージョンでスクリプトを実行してください：
アプリケーションの動作がまだ異なる場合は、サポートサービス pycharm-support@jetbrains.com にお問い合わせください |
特定の Python インタープリターに必要なパッケージがインストールされていません。 特定の Python インタープリター用にインストールされたパッケージのバージョンが古くなっています。 | 次のコマンドを実行して、必要なパッケージをインストールします。
例: これらのコマンドを実行すると、指定されたパッケージの最新バージョンがインストールされます。 特定のバージョンのパッケージをインストールするには、次の式を使用します。
例: 次のコマンドは、バージョン 1.0.2 と互換性のある Flask をインストールします:
例: これらのコマンドを実行すると、指定されたパッケージの最新バージョンがインストールされます。 特定のバージョンのパッケージをインストールするには、次の式を使用します。
例: 次のコマンドは、バージョン 1.0.2 と互換性のある Flask をインストールします: |
パッケージをインストールしようとすると、特定の Python インタープリターで pip が利用できないことがわかります。 | 標準ライブラリから pip を起動してみてください:
例:
例: pip インストールの詳細については、 packaging.python.org(英語) を参照してください。 |
をクリックし、 
をクリックし、