パッケージのインストールの問題

Python パッケージをインストールする際、プロジェクト構造設定または Python パッケージツールウィンドウで問題が発生することがあります。実際のインストールは PyCharm が pip パッケージマネージャーを使用して行うため、ほとんどの問題は IDE の制御外です。

この記事では、トラブルシューティングのヒントを提供し、いくつかの典型的なケースについて説明します。

ターミナルを使用してパッケージをインストールする

最も効果的なトラブルシューティングは、ターミナルを使用して、選択した Python インタープリターに問題のあるパッケージをインストールしてみることです。同じエラーメッセージが表示される場合は、IDE に問題があるわけではないため、原因と一般的なケースを確認するか、インターネットで解決策を検索してください。

仮想環境にパッケージをインストールする

Ctrl+Alt+S を押して設定を開き、 Python | すべてのインタープリターを選択します。
ターゲットインタープリターを見つけて、そのパスをコピーします: インタープリターにカーソルを合わせ、インタープリターのパスをコピーをクリックします。インタープリターのパスは仮想環境へのパスで始まります。
システムターミナル (PyCharm の組み込みターミナルではありません) を開き、次のコマンドを実行します:
. <venv path>/bin/activate pip install <package name>
source <venv path>/bin/activate pip install <package name>
結果をインスペクションして解析します。

conda 環境にパッケージをインストールする

インタープリターの構成時にデフォルトの conda 環境名を変更しなかった場合は、プロジェクト名を使用できます。それ以外の場合は、次の手順を実行します：
- Ctrl+Alt+S を押して、 Python | すべてのインタープリターに移動します。
- インタープリターを見つけ、そのパス内の環境名を確認します。パスをコピーするには、インタープリターにカーソルを合わせ、インタープリターのパスをコピーをクリックします。

システムターミナル (PyCharm の組み込みターミナルではありません) を開き、次のコマンドを実行します:

conda <4.6	conda> = 4.6
activate <conda env name> conda install <package name>	conda activate <conda env name> conda install <package name>

conda <4.6	conda> = 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 を押して Python | すべてのインタープリターに移動します。
インタープリターを見つけて、そのパスをコピーします: インタープリターにカーソルを合わせ、インタープリターのパスをコピーをクリックします。
システムターミナル (PyCharm の組み込みターミナルではありません) を開き、次のコマンドを実行します:
<interpreter path> -m pip install <package name>
システムインタープリターにパッケージをインストールするには、管理者権限が必要になる場合があります。
結果をインスペクションして解析します。

結果を解析する

結果	アクション
Python バージョンがパッケージ要件を満たしていないため、パッケージをインストールできません。	要件を満たす Python バージョンに基づく別の Python インタープリターを作成してみてください。
パッケージをインストールする権限がないため、パッケージをインストールできません。	`sudo pip install <package name>` などのスーパーユーザー権限を使用してパッケージをインストールしてみてください。
選択したパッケージマネージャーでサポートされているリポジトリにパッケージがないため、パッケージをインストールできません。例: conda パッケージマネージャーリポジトリで利用できないパッケージをインストールしようとしています。	プロジェクトに別のタイプの Python インタープリターを構成して、パッケージをインストールしてみてください。 Python インタープリターを構成するで Python インタープリターの追加および変更方法を参照してください。
パッケージをインストールできず、一般的なパッケージインストールの失敗ケースの 1 つと一致します。	ケースを確認するおよび関連する回避策を適用します。
パッケージが正常にインストールされました。	PyCharm 課題トラッカーで課題を作成し、すべてのコンソール出力、エラーメッセージ、ターミナルとプロジェクト構造設定または Python パッケージツールウィンドウで同じインタープリターにパッケージをインストールしようとしたことを示すスクリーンショットなど、ケースに関する明確な詳細を提供します。

典型的なケースを確認する

エラーメッセージ	関連パッケージ	回避策	リファレンス
`fatal error: 'SDL.h' file not found`	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
`Cannot open include file: 'portaudio.h'`	pyaudio	管理者権限を使用して、次のコマンドを実行してみてください。 pip install pipwin pipwin install pyaudio	https://stackoverflow.com/questions/51992375/how-to-fix-installation-issues-for-pyaudio-portaudio-fatal-error-c1083-canno https://www.programmersought.com/article/5816775591/
`SSL module in Python is not available`	任意のパッケージ	オペレーティングシステムに固有の方法で openssl ライブラリをインストールします。詳細なソリューション(英語)を参照してください。	https://stackoverflow.com/questions/41328451/ssl-module-in-python-is-not-available-when-installing-package-with-pip3/54932141#54932141。

エラーメッセージ