PyCharm 2020.2ヘルプ

トラブルシューティング

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

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

報告された問題考えられる原因ソリューション
プロジェクト設定
A Python interpreter is marked as unsupported in the list of available interpreters in 環境設定/設定 | プロジェクト | Python インタープリターマークされたインタープリターのPythonバージョンは古く、PyCharmではサポートされていませんサポートされていないインタープリターを利用可能なインタープリターのリストから削除できます。サポートされているPythonのバージョンについて詳しくは、Pythonサポートを参照してください。
コード編集
PyCharmエディターはコードの編集を制限します。IdeaVimプラグインをインストールして、vim編集モードを有効にしました。

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

Pythonコードはエディターで強調表示されません。PYファイルは、テキストファイル形式に関連付けられています。

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

コード補完
コード補完アクションは使用できません。省電力モードが有効になります。メインメニューからファイルを選択し、省電力モードチェックボックスをオフにします。
ファイルがコンテンツ・ルートに存在しないため、コード補完に必要なクラス定義とリソースを取得できません。ソースファイルを再構成します。
補完候補リストに表示するクラスと関数を含むファイルはプレーンテキストファイルです。ソースファイルのフォーマットを再考し、必要に応じて変更します。
デバッグ
Docker実行/デバッグ構成をデバッグできません。デバッグアクションは使用できません。PyCharmは、Pythonの実行/デバッグ構成のデバッグを提供します。Configure a Docker-based interpreter and debug your Python script in a Docker container.
Pythonデバッガは、Geventコードをデバッグするときにハングします。Gevent互換モードは有効になっていません。

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

いくつかのインポートエラーがPyQtコードで報告されます。PyQtはインタープリターにインストールされますが、アプリケーションコードにインポートされません。

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

デバッグプロセスが遅いです。デバッガは、例外が発生してプロセスが終了したときだけでなく、例外がスローされたとき(プロセスが終了してもプロセスの終了に至らなかった場合でも)に停止します。ブレークポイントダイアログ(実行 | ブレークポイントの表示)のraise 時チェックボックスをクリアします。
ローカルプロセスに接続しようとした最初の試みで、次のエラーメッセージが表示されます。ptrace: Operation not permittedIt a known issue(英語) for 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

  • Python 3.7の場合:

    sudo apt-get install python3.7-dev

  • Python 3.8の場合:

    sudo apt-get install python3.8-dev

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

Command 'gcc' failed with exit status 1 .

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

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

You have already clicked the Install link
in the Cython speedup extensions notification
but PyCharm repeatedly prompts to install it.
You do not have permissions to write in the directories used by PyCharm(英語).権限を確認して変更してください。
パッケージング
パッケージのインストールが失敗します。pip is not available for a particular Python interpreter, or any of the installation requirements is not met.
  • If pip is not available, install it for the required Python interpreter (see the corresponding troubleshooting tip)

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

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

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

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

Docker-composerは、Unixソケット設定を使用するUbuntuでは機能しません。Docker-composerが次のエラーを報告します:
docker.errors.TLSParameterError: Path to a certificate and key files must be provided through the client_config param. TLS configurations should map the Docker CLI client configurations.
  1. プロジェクトの設定/環境設定(Ctrl+Alt+S)を開きます。

  2. ビルド、実行、デプロイ | Dockerに移動します。

  3. TCP ソケットを選択します。

  4. エンジン API URLフィールドに unix:///var/run/docker.sock と入力します。

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

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のProfessionalエディションでのみ使用できます。

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

Check the edition of PyCharm and enable the UML plugin in the plugin settings.

場合によっては、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(英語)を参照してください。

最終更新日: 2020年7月23日

関連ページ:

Python

PyCharmでPythonスクリプトを開発するには、Pythonをダウンロードしてインストールし、少なくとも1つのPython インタープリターを構成します。Windowsユーザーの場合、Windows用Pythonをインストールすることをお勧めします。サポートされるバージョン:Python 2:...

PyCharmでVimエディターエミュレーションを使用する (IdeaVim)

以下は、IdeaVimプラグインがインストールされ使用可能になっている場合にのみ有効です。IdeaVimプラグインは、PyCharmエディターでVimをエミュレートします。これには、通常モード、挿入モード、ビジュアルモード、コマンドラインモードとExモード、Vim正規表現と構成、その他の機能が含まれ...

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

導入:PyCharmとDockerの統合により、Dockerコンテナーにデプロイされたさまざまな構成の開発環境でアプリケーションを実行できます。前提条件:次の前提条件が満たされていることを確認してください。ページDockerドキュメントに記載されているように、Dockerがインストールされています。...

プラグインを管理する

プラグインはPyCharmのコア機能を拡張します。彼ら:バージョン管理システム、アプリケーションサーバー、およびその他のツールとの統合を提供する、さまざまな言語とフレームワークのコーディング支援サポートを追加する、ショートカットヒント、ライブプレビュー、ファイルウォッチャーなどで生産性を向上、コーデ...