PyCharm 2024.1 ヘルプ

PyCharm のトラブルシューティング

PyCharm を使用している間、警告メッセージやエラーメッセージが表示されることがあります。この章では、既知の問題の解決策と回避策の一覧を示します。

また、作業環境のトラブルシューティングと基本的な診断を行うための推奨事項を見つけることもできます。

報告された問題

考えられる原因

ソリューション

プロジェクト設定

Python インタープリターは、環境設定 / 設定 | プロジェクト | Python インタープリターで使用可能なインタープリターのリストでサポートされていないものとしてマークされています。

マークされたインタープリターの Python バージョンは古く、PyCharm ではサポートされていません

サポートされていないインタープリターを使用可能なインタープリターのリストから削除できます。サポートされている Python バージョンの詳細については、「Python サポート」を参照してください。

コード編集

PyCharm エディターはコードの編集を制限します。

IdeaVim プラグインをインストールして、vim 編集モードを有効にしました。

ツールメニューの Vim エミュレーターを選択解除します。詳しくは PyCharm での Vim エディターエミュレーションの使用を参照してください。

Python コードはエディターでハイライトされません。

PY ファイルは、テキストファイル形式に関連付けられています。

設定ダイアログ (Ctrl+Alt+S) で、エディター | ファイルタイプに移動し、認識されたファイルの種類リストからテキストを選択し、ファイル名のパターンリストから *.py を選択して、Remove をクリックします。

コード補完

コード補完アクションは使用できません。

省電力モードが有効になります。

メインメニューからファイルを選択し、省電力モードチェックボックスをオフにします。

ファイルがコンテンツルートに存在しないため、コード補完に必要なクラス定義とリソースを取得できません。

ソースファイルを再構成します。

補完候補リストに表示するクラスと関数を含むファイルはプレーンテキストファイルです。

ソースファイルのフォーマットを再考し、必要に応じて変更します。

デバッグ

Docker 実行 / デバッグ構成をデバッグできません。デバッグアクションは使用できません。

PyCharm は、Python の実行 / デバッグ構成のデバッグを提供します。

Docker ベースのインタープリターを構成し、Docker コンテナーで Python スクリプトをデバッグします。

Python デバッガーは、Gevent コードをデバッグするときにハングします。

Gevent 互換モードは有効になっていません。

設定ダイアログ (Ctrl+Alt+S) で、ビルド、実行、デプロイ | Python デバッガーに移動し、Gevent 互換チェックボックスを選択します。

いくつかのインポートエラーが PyQt コードで報告されます。

PyQt はインタープリターにインストールされますが、アプリケーションコードにインポートされません。

設定ダイアログ (Ctrl+Alt+S) で、ビルド、実行、デプロイ | Python デバッガーに移動し、の PyQt 互換チェックボックスをオフにします。このモードはデフォルトで有効になっています。

デバッグプロセスが遅いです。

デバッガーは、例外が発生してプロセスが終了したときだけでなく、例外がスローされたとき（プロセスが終了してもプロセスの終了に至らなかった場合でも）に停止します。

ブレークポイントダイアログ（実行 | ブレークポイントの表示）の raise 時チェックボックスをクリアします。

次のエラーメッセージは、ローカルプロセスへの最初の接続試行時に表示されます: ptrace: Operation not permitted

これは Ubuntu の既知の問題(英語)です。

kernel.yama.ptrace_scope カーネルパラメーターが 0 に設定されていることを確認します。sudo sysctl kernel.yama.ptrace_scope=0 コマンドで一時的に値を変更するか、kernel.yama.ptrace_scope = 0 行を /etc/sysctl.d/10-ptrace.conf ファイルに追加して恒久的に設定することができます。

Cython のスピードアップ

次のエラーメッセージが表示されます。

Python.h: no such file or directory .

Python のヘッダーファイルと静的ライブラリが不足しています。

パッケージマネージャーを使用して、python-dev パッケージをシステム全体にインストールします。

Linux および macOS では、次のコマンドを実行できます。

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 のドキュメント(英語)を参照してください。

Cython スピードアップ拡張機能の通知でインストールリンクをクリックしましたが、PyCharm は繰り返しインストールを求めます。

PyCharm が使用するディレクトリに書き込む権限がありません。

権限を確認して変更してください。

パッケージング

パッケージのインストールが失敗します。

pip は、特定の Python インタープリターでは使用できないか、インストール要件のいずれかが満たされていません。

  • pip が利用できない場合は、必要な Python インタープリター用にインストールしてください (対応するトラブルシューティングのヒントを参照してください)

  • 特定のパッケージの製品ドキュメントを参照して、オペレーティングシステムとターゲットの Python インタープリターにインストールできることを確認してください。また、追加のシステム要件が満たされているかどうか確認してください。

Docker (Docker のトラブルシューティングを参照)

ファイル監視 環境設定 / 設定 | ツール | ファイル監視ウィンドウに次のメッセージが表示される場合があります。

Unknown Scope error

ファイルウォッチャーは、このプロジェクトで定義されていないスコープを使用します。

ウォッチャーをダブルクリックして、使用可能なスコープを選択するか、新しいスコープを作成します。

Not found error

このプロジェクトは、削除されたグローバルファイル監視を使用します。

除去ボタン Remove を使用してリストからウォッチャーを削除するか、編集して同じ名前の新しいグローバルウォッチャーを作成します。

デプロイ

SSH 設定使用時のエラーメッセージ:

Connection to <server> failed: SSH: invalid privatekey: [<key>. SSH: invalid privatekey: <key>

OpenSSH キーの RFC4716 形式は、PyCharm ではサポートされていません。

  • ssh-add コマンドを使用して秘密鍵を ssh-agent に追加します (詳細は ssh.com(英語) を参照してください)

  • Python インタープリターの追加ダイアログで設定手順を繰り返します。

  • ssh-add コマンドを使用して秘密鍵を ssh-agent に追加します (詳細は ssh.com(英語) を参照してください)

  • 設定ダイアログ (Ctrl+Alt+S) で、ビルド、実行、デプロイ | デプロイを選択し、SFTP デプロイ構成を選択します。

    認証リストから OpenSSH 構成および認証エージェントを選択します。

プロファイルコマンドは、実行メニューでは使用できません。

  • この機能は、PyCharm の Professional エディションでのみ使用できます。

  • PyCharm Professional にバンドルされている Diagrams プラグインが無効になっています。

PyCharm のエディションを確認し、プラグイン設定でダイアグラムプラグインを有効にします。

場合によっては、PyCharm または作業環境で問題が発生しているかどうかを識別する診断手順を実行する必要があります。以下は便利なヒントの一覧です。

トラブルシューティングのケース

診断処置

PyCharm およびターミナルウィンドウでアプリケーションを実行すると、アプリケーションの動作が異なることがあります。

PyCharm プロジェクト設定で指定された python バージョンでスクリプトを実行します。

  1. PyCharm で、設定ダイアログ Ctrl+Alt+S を開き、プロジェクト <プロジェクト名> | Python インタープリターに移動します。

  2. Python インタープリターフィールドの近くにある Interpreter をクリックし、すべて表示 ... を選択します。プロジェクトで使用するインタープリターは、使用可能なインタープリターのリストで選択されます。

  3. Edit interpreter をクリックし、インタープリターパスフィールドからパスをコピーします。

  4. 次に、コピーしたパスを使用してターミナルウィンドウでスクリプトを実行します

    <copied python interpreter path> <path to the python script>\my_script.py 例: C:\Python27\python.exe C:\Samples\my_script.py

  1. PyCharm で、環境設定ダイアログ Ctrl+Alt+S を開き、プロジェクト <プロジェクト名> | Python インタープリターに移動します。

  2. 「Python インタープリター」フィールドの横にある「 Interpreter 」をクリックし、「すべて表示 ...」を選択します。プロジェクトで使用するインタープリターは、使用可能なインタープリターのリストで選択されます。

  3. Edit interpreter をクリックし、インタープリターパスフィールドからパスをコピーします。

  4. 次に、コピーしたパスを使用してターミナルウィンドウでスクリプトを実行します

    <copied python interpreter path> <path to the python script>/my_script.py 例: /Users/jetbrains/bin/python3 /Users/jetbrains/Samples/my_script.py

アプリケーションの動作がまだ異なる場合は、サポートサービス pycharm-support@jetbrains.com にお問い合わせください

特定の Python インタープリターに必要なパッケージがインストールされていません。特定の Python インタープリター用にインストールされたパッケージのバージョンが古くなっています。

次のコマンドを実行して、必要なパッケージをインストールします。

<path to the python executable>\python.exe -mpip install '<package>'

例: C:\Python27\python.exe -mpip install 'Flask'

これらのコマンドを実行すると、指定されたパッケージの最新バージョンがインストールされます。

特定のバージョンのパッケージをインストールするには、次の式を使用します。

  • '<package>==<package_version>' – パッケージの特定のバージョンをインストールします

  • '<package>>=<package_version>' – 指定されたバージョン以降のパッケージをインストールします

  • '<package>~=<package_version>' – 指定されたバージョンのパッケージと互換性のあるバージョンをインストールします

例: 次のコマンドは、バージョン 1.0.2 と互換性のある Flask をインストールします: C:\Python27\python.exe -mpip install 'Flask~=1.0.2'

<path to the python executable/python -mpip install '<package>'

例: /Users/jetbrains/anaconda3/bin/python -mpip install 'Flask'

これらのコマンドを実行すると、指定されたパッケージの最新バージョンがインストールされます。

特定のバージョンのパッケージをインストールするには、次の式を使用します。

  • '<package>==<package_version>' – パッケージの特定のバージョンをインストールします

  • '<package>>=<package_version>' – 指定されたバージョン以降のパッケージをインストールします

  • '<package>~=<package_version>' – 指定されたバージョンのパッケージと互換性のあるバージョンをインストールします

例: 次のコマンドは、バージョン 1.0.2 と互換性のある Flask をインストールします: /Users/jetbrains/anaconda3/bin/python -mpip install 'Flask~=1.0.2'

パッケージをインストールしようとすると、特定の Python インタープリターで pip が利用できないことがわかります。

標準ライブラリから pip を起動してみてください:

<path to the python executable>\python.exe -m ensurepip --default-pip

例: C:\Python27\python.exe -m ensurepip --default-pip

<path to the python executable/python -m ensurepip --default-pip

例: /Users/jetbrains/anaconda3/bin/python -m ensurepip --default-pip

pip インストールの詳細については、packaging.python.org(英語) を参照してください。

キーマップリファレンス ファイルタイプの問題

関連ページ：

Python

PyCharm で Python スクリプトを開発するには:Python をダウンロードしてインストールします。少なくとも 1 つの Python インタープリターを構成します。Windows ユーザーの場合、Windows 用 Python をインストールすることをお勧めします。サポートされるバージョン：Python 2: バージョン 2.7、Python 3: バージョン 3.6 からバージョン 3.12 まで、次の機能は、Python 3.12 サポートの一部として使用できます。PEP 695...

PyCharm で Vim エディターを使用する (IdeaVim)

IdeaVim は、PyCharm エディター用の Vim エンジンです。通常モード、挿入モード、ビジュアルモード、コマンドラインモードと Ex モード、Vim 正規表現と構成、およびその他の機能をサポートしています。IdeaVim プラグインをインストールする設定ダイアログで、プラグインを選択します。マーケットプレースで IdeaVim プラグインを見つけて、インストールをクリックします。PyCharm を再起動してください。PyCharm を再起動すると、Vim が有効になり、エディターが Vim...

Docker を使用してインタープリターを構成する

導入：PyCharm と Docker の統合により、Docker コンテナーにデプロイされたさまざまな構成の開発環境でアプリケーションを実行できます。前提条件：次の前提条件が満たされていることを確認してください。Docker のドキュメントに従って、Docker がインストールされます。Docker はさまざまなプラットフォームにインストールできますが、ここでは Windows インストールを使用します。異なるプラットフォームでこのチュートリアルを繰り返すことをお勧めします。次に、macOS および...

プラグインのインストール

プラグインは PyCharm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケット...

ファイルタイプの問題

場合によっては、.py などのソースコードファイルがプレーンテキストファイルのように見え始めることがあります。通常、これは多くのファイルのうちの 1 つのファイルにのみ発生します。これは、ファイルタイプの設定が誤って変更されたことが原因です。ファイルタイプのステータスを確認するには、を押して設定を開き、エディター | ファイルタイプを選択して、テキストとファイルの内容から自動検出されたファイルタイプを確認します。これらのファイルタイプのいずれかでファイル名が見つかった場合は、「」をクリックして削...