PyCharm 2019.2ヘルプ

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

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

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

報告された問題

考えられる原因

ソリューション

プロジェクト設定

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

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

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

コード編集

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

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

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

Pythonコードはエディターで強調表示されません。

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

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

コード補完

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

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

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

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

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

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

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

デバッグ

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システム全体のヘッダファイルと静的ライブラリーをインストールしてください。

例:次のコマンドを使用できます。

  • Python 2.xの場合:

    sudo apt-get install python-dev

  • Python 3.5の場合:

    sudo apt-get install python3-dev

  • Python 3.6の場合:

    sudo apt-get install python3.6-dev

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

Command 'gcc' failed with exit status 1 .

Cコンパイラが不足しています。

デバッガ用のCython拡張機能を構築するためにCコンパイラをインストールします。

すでにインストールリンクをクリックしています
Cythonのスピードアップ機能拡張の通知に
しかしPyCharmはそれをインストールするよう繰り返し要求します。

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

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

パッケージング

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

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

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

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

Docker

Dockerに接続できません

Dockerが動作していないか、Dockerの接続設定が正しくありません。

Windows用のDockerを使用している場合は、Docker設定の一般セクションでTLSなしでtcp://localhost:2375上のデーモンを公開オプションを有効にします。

Docker Toolboxを使用している場合は、Dockerマシンが実行中であり、その実行可能ファイルがビルド、実行、デプロイ | Docker | ツール設定/環境設定ダイアログ Ctrl+Alt+S で正しく指定されていることを確認してください。

イメージをプルしようとすると、次のメッセージが表示されます。

Failed to parse dockerCfgFile: <your_home_dir>/.docker/config.json, caused by: ... {"credsStore":"wincred"}

credsStore使用時の認証設定ファイルが無効です: http://github.com/docker-java/docker-java/issues/806(英語)

<your_home_dir>/.docker ディレクトリーに移動し、config.json ファイルを削除してください。

Docker Composeを使用できません

Docker Compose実行ファイルが正しく指定されていません。

設定/環境設定ダイアログビルド、実行、デプロイ | Docker | ツールCtrl+Alt+S でDocker Compose実行可能ファイルを指定する

ポートバインディングを使用できません

コンテナーポートは公開されていません。

Dockerfile(英語)EXPOSE(英語)コマンドを使用する

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

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 Configと認証エージェントを選択します。

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

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

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

診断処置

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

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

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

  2. プロジェクト・インタープリターフィールドの近くの 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を開き、プロジェクト<プロジェクト名> | プロジェクト・インタープリターにナビゲートします。

  2. プロジェクト・インタープリターフィールドの横にある 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(英語)を参照してください。

最終更新日: 2019年10月14日