パッケージのインストールの問題
プロジェクト設定または Python パッケージツールウィンドウで Python パッケージをインストールするときに問題が発生する可能性があります。最終的に、PyCharm は pip パッケージマネージャー(英語)を使用して実際のインストールを実行するため、ほとんどの問題は IDE の制御不能になります。
この記事では、トラブルシューティングのヒントを提供し、いくつかの典型的なケースについて説明します。
ターミナルを使用してパッケージをインストールする
最も実行可能なトラブルシューティングアクションは、ターミナルを使用して、選択した Python インタープリターに問題のあるパッケージをインストールしてみることです。同じエラーメッセージが表示された場合、問題は IDE にないため、理論的根拠と一般的なケースを確認するか、インターネットで解決策を検索する必要があります。
仮想環境にパッケージをインストールする
Ctrl+Alt+S を押して設定を開き、
を選択します。利用可能なインタープリターのリストを展開し、すべて表示をクリックします。
ターゲットのインタープリターを見つけて、仮想環境へのパスをコピーします。
システムターミナル (PyCharm の組み込みターミナルではありません) を開き、次のコマンドを実行します。
source <venv path>/Scripts/activate pip install <package name>source <venv path>/bin/activate pip install <package name>
conda 環境にパッケージをインストールする
インタープリターの構成時にデフォルトの conda 環境名を変更しなかった場合は、プロジェクト名を使用できます。それ以外の場合は、次の手順を実行します。
Ctrl+Alt+S を押して、
に移動します。プロジェクトインタープリターのリストを展開して下にスクロールし、すべて表示を選択します。
インタープリターを見つけて、
名前変更を押して、環境名をコピーします。
システムターミナル (PyCharm の組み込みターミナルではありません) を開き、次のコマンドを実行します。
コンダ < 4.6
コンダ>= 4.6
activate <conda env name> conda install <package name>conda activate <conda env name> conda install <package name>コンダ < 4.6
コンダ>= 4.6
source activate <conda env name> conda install <package name>conda activate <conda env name> conda install <package name>環境のアクティブ化の詳細については、conda のドキュメント(英語)を参照してください。
考えられる失敗ケースの 1 つは、conda パッケージマネージャーがサポートするリポジトリでターゲットパッケージが利用できない場合に発生します。
システムインタープリターにパッケージをインストールする
パッケージをインストールしようとしていた現在選択されているシステムインタープリターのパスを確認するには、Ctrl+Alt+S を押して
に移動します。利用可能なインタープリターのリストを展開し、すべて表示をクリックします。
インタープリターを見つけてパスをコピーします。
システムターミナル (PyCharm の組み込みターミナルではありません) を開き、次のコマンドを実行します。
<interpreter path> -m pip install <package name>システムインタープリターにパッケージをインストールするには、管理者権限が必要になる場合があります。
結果を解析する
結果 | アクション |
---|---|
Python バージョンがパッケージ要件を満たしていないため、パッケージをインストールできません。 | 要件を満たす Python バージョンに基づく別の Python インタープリターを作成してみてください。 |
パッケージをインストールする権限がないため、パッケージをインストールできません。 | |
選択したパッケージマネージャーがサポートするリポジトリでパッケージが利用できないため、パッケージをインストールできません。例: conda パッケージマネージャーリポジトリで利用できないパッケージをインストールしようとしています。 | プロジェクトに別のタイプの Python インタープリターを構成して、パッケージをインストールしてみてください。Python インタープリターを構成するで Python インタープリターを追加および変更する方法を参照してください。 |
パッケージをインストールできず、一般的なパッケージインストールの失敗ケースの 1 つと一致します。 | ケースを確認するおよび関連する回避策を適用します。 |
パッケージが正常にインストールされました。 | PyCharm 課題トラッカー(英語)で問題を報告し、すべてのコンソール出力、エラーメッセージ、ターミナルとプロジェクト設定、Python パッケージツールウィンドウで同じインタープリターにパッケージをインストールしようとしたことを示すスクリーンショットを含む、ケースに関する明示的な詳細を提供します。 |
典型的なケースを確認する
エラーメッセージ | 関連パッケージ | 回避策 | リファレンス |
---|---|---|---|
| pygame、pysc2 | パッケージには SDL が必要であり、pip はそれを検出できないため、インストールは失敗します。次のコマンドを試してください。
brew install sdl sdl_image sdl_mixer sdl_ttf portmidi;
pip3 install pygame;
pip install pygame
| https://stackoverflow.com/questions/45992243/pip-install-pygame-sdl-h-file-not-found(英語) |
| pyaudio | 管理者権限を使用して、次のコマンドを実行してみてください。
pip install pipwin
pipwin install pyaudio
| |
| 任意のパッケージ | オペレーティングシステムに固有の方法で openssl ライブラリをインストールします。詳細なソリューション(英語)を参照してください。 |
関連ページ:
![](https://resources.jetbrains.com/help/img/idea/2024.1/py_packages_tool_window_view.png)
パッケージのインストール、アンインストール、アップグレード
PyCharm は、特定の Python インタープリター用の Python パッケージをインストール、アンインストール、アップグレードするための方法を提供します。これは、各プロジェクトに独自のパッケージセットがあることを意味し、これが Python 依存関係管理のベストプラクティスと考えられます。デフォルトでは、PyCharm は pip を使用してプロジェクトパッケージを管理します。conda 環境の場合は、conda パッケージマネージャーを使用できます。PyCharm では、Python パ...
![](https://resources.jetbrains.com/help/img/idea/2024.1/py_python_interpreter_widget.png)
Python インタープリターを構成する
PyCharm の Python インタープリター:PyCharm で Python コードを操作するには、少なくとも 1 つの Python インタープリターを構成する必要があります。Python インストールで利用可能なシステムインタープリターを使用できます。Virtualenv、pipenv、Poetry、conda 仮想環境を作成することもできます。仮想環境は、基本インタープリターとインストールされたパッケージで構成されます。PyCharm Professional では、SSH、Vagr...
![](https://resources.jetbrains.com/help/img/idea/2024.1/py_file_type_issues1.png)
ファイルタイプの問題
場合によっては、.py などのソースコードファイルがプレーンテキストファイルのように見え始めることがあります。通常、これは多くのファイルのうちの 1 つのファイルにのみ発生します。これは、ファイルタイプの設定が誤って変更されたことが原因です。ファイルタイプのステータスを確認するには、を押して設定を開き、エディター | ファイルタイプを選択して、テキストとファイルの内容から自動検出されたファイルタイプを確認します。これらのファイルタイプのいずれかにファイル名が見つかった場合は、をクリックしてファイ...
![](https://pleiades.io/icons/pycharm.png)
フィードバックを送信
エラー報告、改善提案、新しい機能要求、JetBrains チームに伝えたいその他のご意見は、下記のアドレスまでお寄せください。JetBrains のサポート、Community のサポート、パッケージのインストールの問題