PyCharm パッケージ管理と仮想環境

Python エコシステムの強みは豊富なサードパーティ製パッケージにあります。そして、これらのパッケージとその依存関係を管理することは、すべてのプロジェクトの必修科目です。

PyCharm はグラフィカルなパッケージ管理インターフェースと統合されたターミナルツールを提供し、パッケージのインストール、アップグレード、アンインストールを直感的かつ効率的にします。

また、PyCharm は仮想環境のサポートにより、異なるプロジェクト間の依存関係の競合を効果的に隔離できます。

グラフィカルインターフェースによるパッケージの表示とインストール

PyCharm は直感的なパッケージ管理パネルを提供しており、コマンドラインを覚えることなくパッケージの日常操作を行うことができます。

右側のパネルで、現在のインタープリターにインストールされているすべてのパッケージとそのバージョンを確認できます。

検索ボックスにパッケージ名を入力します（例:requests）。対象のパッケージを見つけたら、「Install Package」ボタンをクリックします。

インストールが完了すると、新しいパッケージはインストール済みリストに表示され、すぐに使用できます。

パッケージを検索すると、PyCharm は PyPI リポジトリからパッケージの説明、バージョン、依存関係などの最新情報を取得し、選択の参考にできます。

内蔵ターミナル（Terminal）を使用したパッケージのインストール

コマンドライン操作に慣れている場合は、PyCharm に内蔵されたターミナル（Terminal）ツールウィンドウが最適な選択肢です。

ターミナルを開く

下部ツールバーの「Terminal」タブをクリックするか、ショートカットキーAlt + F12を使用して内蔵ターミナルを開きます。

ターミナルは現在のプロジェクトの仮想環境を自動的にアクティブ化し、コマンドプロンプトの前に環境名が表示されます。

よく使用する pip コマンド

# 安装单个包
pip install requests

# 安装指定版本的包
pip install requests==2.28.0

# 同时安装多个包
pip install requests flask numpy

# 升级已安装的包到最新版本
pip install --upgrade requests

# 卸载包
pip uninstall requests

# 查看已安装的所有包
pip list

# 查看某个包的详细信息
pip show requests

PyCharm の内蔵ターミナルは外部ターミナルと完全に同じで、すべての pip コマンドとシステムコマンドをサポートし、仮想環境とシームレスに統合されています。

仮想環境の管理

仮想環境は Python 開発における中核的なプラクティスであり、各プロジェクトが独立した依存関係スペースを持ち、互いに干渉しないことを保証します。

新しい仮想環境の作成

新規プロジェクトを作成するとき、PyCharm はデフォルトで新しい仮想環境の作成を促します。

既存のプロジェクトで手動で作成することもできます:

「設定。
」を開き、既存の仮想環境を確認します。
「インタープリターの追加」を選択し、環境の保存場所と基本 Python インタープリターを指定します。
「確認」をクリックして、作成を完了します。

Conda 環境への切り替え

Anaconda または Miniconda を使用して Python 環境を管理している場合、PyCharm もネイティブサポートを提供しています。

Python Interpreter 設定ページで歯車アイコンをクリックし、「Add...。
」を選択します。左側で「Conda Environment。
」を選択します。「Existing environment」を選択すると、PyCharm はシステムにインストールされている Conda 環境を自動的に検出します。
ドロップダウンリストから対象の環境を選択し、「OK」をクリックして、切り替えを完了します。

仮想環境を切り替えると、PyCharm はパッケージリストを自動的に再インデックスします。インデックスが完了するまでお待ちください。完了しないと、コード補完や型チェックが正確でない可能性があります。

requirements.txt の自動検出

requirements.txtは Python プロジェクトで最も一般的な依存関係宣言ファイルであり、PyCharm はそれに対してスマートなサポートを提供します。

自動検出と通知

次のファイルrequirements.txtを含むプロジェクトを開くと、PyCharm がそのファイル内の一部のパッケージがまだインストールされていないことを検出した場合、エディターの上部に目立つ通知バーが表示されます。

通知の内容は次のようなものです:"Package requirements 'requests', 'flask' are not satisfied"。

通知バー内のInstall requirementsリンクをクリックすると、PyCharm が自動的に pip を呼び出して、欠落しているすべてのパッケージをインストールします。

requirements.txt の自動生成

PyCharm に requirements.txt ファイルを生成させることもできます。

ターミナルで次のコマンドを実行します:

# 将当前虚拟环境中所有已安装的包导出到 requirements.txt
pip freeze > requirements.txt

その後、他の開発者がプロジェクトを入手したら、pip install -r requirements.txtを実行するだけで、すべての依存関係をワンクリックでインストールできます。

次のファイルrequirements.txtを Git のバージョン管理に含めることをお勧めします。これにより、チームメンバーと CI/CD パイプラインは同じ依存関係環境に基づいて開発とビルドを行うことができます。

その他の拡張