pyproject.toml を使用する
プロジェクトの依存関係は、プロジェクトディレクトリ内の pyproject.toml ファイルで指定できます。pyproject.toml を手動で作成することも、自動的に作成されるように Poetry 環境を構成することもできます。
PyCharm は、パッケージ名用のコード補完と、不足している依存関係をインストールするためのクイックフィックスを提供します。
プロジェクトの依存関係を指定する
エディターで pyproject.toml を開きます。
[project]セクションを検索または作成します。必要なパッケージの名前を
dependencies配列内の文字列として指定します。パッケージ名の入力を開始すると、PyCharm には補完オプションが表示されます。
Enter を押して提案を挿入します。
プロジェクトのオプションの依存関係(英語)を [project.optional-dependencies] セクションで指定したり、[build-system.requires] でビルド時の依存関係(英語)を指定したりすることもできます。
パッケージの名前がハイライトされている場合は、このパッケージが現在の Python インタープリターにインストールされていないことを意味します。
不足しているパッケージをインストールする
ハイライトされたパッケージ名にキャレットを置き、Alt+Enter を押します。
パッケージのインストールをクリックします。
.lock ファイルを更新する
エディターで pyproject.toml を開きます。
依存関係を追加、削除、変更するには、pyproject.toml を編集します。
.lock ファイルが古くなった場合、エディターの右上隅に利用可能なアクションを示すポップアップが表示されます。ポップアップが表示されない場合は、その領域にマウスを移動するとポップアップが表示されます。
利用可能なアクションは環境の種類によって異なります。
Poetry ロック : pyproject.toml の依存関係と一致するように詩 .lock ファイルを更新します。
Poetry アップデート : pyproject .toml に基づいて依存関係をインストールまたは更新し、それに応じて poetry.lock ファイルを更新します。
詳細は、Poetry のドキュメント(英語)を参照してください。
- uv ロック : すべての依存関係を許可された最新バージョンにアップグレードし、uv.lock ファイルを更新します。
- uv 同期 : プロジェクトの環境を更新して、すべての依存関係が uv.lock ファイルと最新であることを確認します。
Python パッケージツールウィンドウから uv.lock ファイルを更新し、インストールされたパッケージを管理できます。
Python パッケージツールウィンドウを開きます。uv.lock ファイルが同期されていない場合は、uv ロックの更新をクリックして最新の状態にします。
インストールしたパッケージをアンインストール、アップグレード、レビューすることもできます。
詳細については、uv のドキュメント(英語)を参照してください。
- ハッチラン : デフォルトの Hatch 環境を実行し、pyproject.toml ベースのパッケージをインストールまたは更新します。依存関係が変更された場合、環境は自動的に更新され、それらの変更が反映されます。
詳細は、ハッチドキュメント(英語)を参照してください。
関連ページ：
Poetry 環境を構成する
Poetry は、プロジェクトの依存関係に基づいて Python 仮想環境を簡単に作成できるツールです。プロジェクトが依存するライブラリを宣言でき、Poetry がインストールして更新します。プロジェクトの依存関係は、必要なパッケージ、スクリプト、プラグイン、URL を指定する pyproject.toml ファイルに記録されます。ファイルの構造と形式の詳細については、pyproject リファレンスを参照してください。PyCharm で Poetry を使用するには、Poetry をマシンにインストー...
パッケージのインストール、アンインストール、アップグレード
PyCharm は、特定の Python インタープリター用の Python パッケージをインストール、アンインストール、アップグレードする方法を提供します。これは、各プロジェクトに独自のパッケージセットがあることを意味し、これは Python 依存関係管理のベストプラクティスと見なされます。デフォルトでは、PyCharm はプロジェクトパッケージの管理に pip を使用します。conda 環境では、conda パッケージマネージャーを使用できます。PyCharm では、Python パッケージツー...
Pipfile を使用する
Pipfile は、Pipenv 仮想環境がプロジェクトの依存関係を管理するために使用する専用ファイルです。このファイルは、Pipenv を使用するために不可欠です。新規または既存のプロジェクト用に Pipenv 環境を作成すると、Pipfile が自動的に生成されます。ファイルが現在のプロジェクトに追加され、プロジェクトツールウィンドウで確認できます。同様に、PyCharm で Pipfile ファイルを使用してプロジェクトを初めて開くと、Pipenv 仮想環境が自動的に構成されます。依存関係のリスト...
プロジェクトツールウィンドウ
プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認し、新しい項目 (ディレクトリ、ファイル、クラスなど) の作成、エディターでのファイルのオープン、必要なコードフラグメントへの移動などのさまざまなタスクを実行できます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。このビューには、作成されたスクラッチファイル、クエリファイル、および拡張スクリプトを管理できるスクラッチとコン...