uv 環境を構成する
uv(英語) ツールを使用すると、Python の開発が容易になり、新しいプロジェクトのセットアップタスクが削減され、既存のプロジェクトの管理が容易になります。
PyCharm で uv を使用するには、マシンに uv をインストール(英語)し、特定の Python 環境を作成する必要があります。
新しい Python プロジェクトの作成時に uv を選択すると、PyCharm は自動的に pyproject.toml ファイルを生成します。このファイルには、必要なパッケージ、スクリプト、プラグイン、URL が指定されています。ファイルの構造と形式の詳細については、pyproject(英語) ガイドを参照してください。
uv 環境を作成する
以下のいずれか 1 つを実行します:
Python インタープリターセレクターをクリックして、新しいインタープリターを追加を選択します。
Ctrl+Alt+S を押して設定を開き、に移動します。
Python インタープリターセレクターをクリックしてインタープリターの設定を選択します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。
利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックし、ローカルインタープリターを追加するを選択します。
次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。
- 新しい uv 環境
環境タイプのリストから uv を選択します。
リストから Python のバージョンを選択します。
PyCharm は uv のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、uv 実行可能ファイルの場所を指定するか、
をクリックして参照します。
- 既存の uv 環境
環境タイプのリストから uv を選択します。
PyCharm は uv のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、uv 実行可能ファイルの場所を指定するか、
をクリックして参照します。リストから環境を選択します。
選択した uv 環境は、現在のプロジェクトで再利用されます。
タスクを完了するには、OK をクリックします。
UV 環境を構成したら、ターミナルまたは uv 実行 / デバッグ構成を使用してプロジェクトを実行できます。
uv ワークスペースのサポート
PyCharm は uv ワークスペース(英語)と uv パス依存関係をサポートしています。ワークスペースモードを有効にした状態でプロジェクトを開くと、PyCharm がワークスペースメンバーとその依存関係を自動的に設定します。
uv ワークスペースは、すべてのプロジェクトで共有される単一の仮想環境を使用しますが、uv パス依存関係は、各プロジェクトに独自の仮想環境を提供します。
ワークスペースメンバーで .py または pyproject.toml ファイルが開かれると、PyCharm はシステム上にこのワークスペースの環境がすでに存在するかどうかを確認します。存在する場合は、環境は自動的に SDK として設定されます。存在しない場合は、ファイルレベルの通知で、このワークスペースメンバー用に新しい uv 環境を作成し、依存関係をインストールするように促されます。
PyCharm は環境の一貫性を検証し、pyproject.toml で定義されている依存関係が環境に存在しない場合は警告を表示します。不足している依存関係をインストールするためのクイックフィックスが提供されます。パッケージがインポートされているにもかかわらず、ワークスペースメンバーの pyproject.toml にリストされていない場合は、クイックフィックスによってパッケージを環境に追加し、対応する .toml ファイルを更新することが提案されます。
ワークスペースメンバー間の依存関係は、ファイルでは読み取り専用として視覚的に表示されます。変更を加えるには、pyproject.toml ファイルを直接編集してください。
詳細は、ワークスペースとモノレポを参照してください。
構成された Python インタープリター (ただし Docker ベース) のいずれかに対して、次の操作を実行できます。
関連ページ：
Python プロジェクトを作成する
純粋な Python プロジェクトは、Python プログラミングを対象としています。プロジェクトは、ソースコード、テスト、使用するライブラリ、個人設定を 1 つのユニットに整理できます。プロジェクトが不要な場合は、LightEdit モードでファイルを編集するか、プロジェクトを設定せずに Python ファイルを作成できます。プロジェクトを作成するには、次のいずれかを実行します。に移動します。ウェルカム画面で、新規プロジェクトをクリックします。、新規プロジェクトダイアログで、プロジェクトの場所...
pyproject.toml を使用する
プロジェクトの依存関係は、プロジェクトディレクトリ内の pyproject.toml ファイルで指定できます。pyproject.toml を手動で作成することも、自動的に作成されるように Poetry 環境を構成することもできます。PyCharm は、パッケージ名用のコード補完と、不足している依存関係をインストールするためのクイックフィックスを提供します。プロジェクトの依存関係を指定するエディターで pyproject.toml を開きます。セクションを検索または作成します。必要なパッケージの名前を配列内...
Python インタープリターを構成する
PyCharm の Python インタープリター：Python コードを PyCharm で動作させるには、少なくとも 1 つの Python インタープリターを設定する必要があります。Python インストールで利用可能なシステムインタープリターを使用できます。また、Virtualenv、pipenv、Poetry、uv、hatch、または conda の仮想環境を作成することもできます。仮想環境は、ベースインタープリターとインストールされたパッケージで構成されます。PyCharm Pro で...
UV ラン
作成: ツールバー：実行 / デバッグ構成のツリー表示には、プロジェクトで使用可能な構成を管理したり、デフォルトの構成テンプレートを調整したりするのに役立つツールバーがあります。実行 / デバッグ構成を作成します。選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。このボタンは、一時的な構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとし...
インタープリターのパスを管理する
PyCharm は、選択されたインタープリターにパスを追加することを可能にします。これらのパスは環境変数に追加されます。また、PyCharm はこれらのパスのインデックスを作成し、コードのオブジェクト（たとえば、パッケージのインポート）を（潜在的に）解決します。インタープリターのパスを表示以下のいずれか 1 つを実行します: を押して設定を開き、を選択します。Python インタープリターセレクターをクリックして、インタープリターの設定を選択します。、利用可能なインタープリターのリストを展開し、す...
パッケージのインストール、アンインストール、アップグレード
PyCharm は、特定の Python インタープリター用の Python パッケージをインストール、アンインストール、アップグレードする方法を提供します。これは、各プロジェクトに独自のパッケージセットがあることを意味し、これは Python 依存関係管理のベストプラクティスと見なされます。デフォルトでは、PyCharm はプロジェクトパッケージの管理に pip を使用します。conda 環境では、conda パッケージマネージャーを使用できます。PyCharm では、Python パッケージツー...