PyCharm 2025.3 ヘルプ

conda 仮想環境を構成する

PyCharm は、Conda(英語) を使用した Python の仮想環境の作成をサポートしています。次の手順は、サポートされているすべてのオペレーティングシステムに適用されます。このページの上部にあるプラットフォームスイッチャーを使用して、オペレーティングシステムに固有のショートカットを表示します。

conda 環境を作成する

  1. Anaconda(英語) または Miniconda(英語) がコンピューターにダウンロードされインストールされていること、およびその実行可能ファイルへのパスを認識していることを確認します。

    詳細については、インストール手順(英語)を参照してください。

  2. 以下のいずれか 1 つを実行します:

    • Python インタープリターセレクターをクリックして、新しいインタープリターを追加を選択します。

    • Ctrl+Alt+S を押して設定を開き、Python | インタープリターに移動します。

    • Python インタープリターセレクターをクリックしてインタープリターの設定を選択します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。

  3. 利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックし、ローカルインタープリターを追加するを選択します。

  4. 次のアクションは、新しい conda 環境を作成するか、既存の環境を使用するかによって異なります。

    新しい conda 環境
    Generate new conda environment
    1. 環境タイプのリストから Conda を選択します。

    2. リストから Python のバージョンを選択します。

    3. 環境名を指定します。

    4. PyCharm は conda のインストールを検出します。

      PyCharm がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、Conda executable location をクリックして参照します。

    既存の conda 環境
    Select existing conda environment
    1. 環境タイプのリストから Conda を選択します。

    2. PyCharm は conda のインストールを検出します。

      PyCharm がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、Browse... をクリックして参照します。

    3. リストから環境を選択します。

    選択した conda 環境は、現在のプロジェクトで再利用されます。

  5. タスクを完了するには、OK をクリックします。

ソースファイルのあるディレクトリに environment.yml ファイルが含まれている場合、PyCharm はそれに基づいて conda 環境を作成できます。

environment.yml に基づいて conda 環境を作成する

  1. 以下のいずれか 1 つを実行します:

    • ファイル | オープンに移動します。

    • ウェルカム画面で、オープンをクリックします。

  2. ソースファイルと environment.yml ファイルを含むディレクトリを参照し、オープン (Mac の場合) または OK (Windows の場合) をクリックします。

    Opening a yml file
  3. 以前にプロジェクトを作成しておらず、そのディレクトリに Python インタープリターを構成していない場合、PyCharm は conda 環境を作成することを提案します。

    Create a Conda environment using the requirements.txt file
  4. 提案されたオプションをそのまま使用するか、別の Conda 実行可能ファイルを指定します。タスクを完了するには、OK をクリックします。

OK をクリックすると、PyCharm は環境を作成し、必要なすべてのパッケージをインストールします。

Conda 環境を作成するための提案を無視すると、PyCharm はプロジェクト用の Python インタープリターを作成しないことに注意してください。そのため、.py ファイルを開くたびに、プロジェクトインタープリターを構成するためのオプションを含む警告が表示されます。

Warning with options for configuring a project interpreter

environment.yml を使用して conda パッケージを管理する

  1. conda 環境を使用するプロジェクトを開きます。プロジェクトに environment.yml ファイルが含まれていることを確認し、含まれていない場合は作成してください。

  2. エディターで environment.yml を開きます。

  3. エディターの右上隅にマウスを移動すると、フローティングツールバーが表示されます。

  4. 利用可能なアクションのいずれかを選択します。

    • Conda 「environment.yml」へのエクスポート : 現在の環境状態を environment.yml ファイルにエクスポートします。

      Conda Export to .yml
    • Conda 「environment.yml」からの更新 : environment.yml ファイルに基づいて現在の環境を更新します。

      Conda Update from .yml

詳細は、Conda のドキュメント(英語)を参照してください。

構成された Python インタープリター (ただし Docker ベース) のいずれかに対して、次の操作を実行できます。

2025 年 10 月 27 日

関連ページ:

Python インタープリターを構成する

PyCharm の Python インタープリター:Python コードを PyCharm で動作させるには、少なくとも 1 つの Python インタープリターを設定する必要があります。Python インストールで利用可能なシステムインタープリターを使用できます。また、Virtualenv、pipenv、Poetry、uv、hatch、または conda の仮想環境を作成することもできます。仮想環境は、ベースインタープリターとインストールされたパッケージで構成されます。PyCharm Pro で...

ウェルカム画面

PyCharm は、IDE を起動するか、他のすべてのプロジェクトを閉じると、ウェルカム画面を表示します。これは完全に機能するプロジェクト環境であり、新しいプロジェクトを作成したり、教育向け PyCharm を使用した学習パスを開始したり、バージョン管理から既存のプロジェクトを開いたりチェックアウトしたりできます。ウェルカム画面の左側にあるプロジェクトとファイルペインを使用して、既存のプロジェクトを開いたり、新しいプロジェクトを作成したり、リポジトリからクローンを作成したり、リモート開発環境に接続...

インタープリターのパスを管理する

PyCharm は、選択されたインタープリターにパスを追加することを可能にします。これらのパスは環境変数に追加されます。また、PyCharm はこれらのパスのインデックスを作成し、コードのオブジェクト(たとえば、パッケージのインポート)を(潜在的に)解決します。インタープリターのパスを表示以下のいずれか 1 つを実行します: を押して設定を開き、を選択します。Python インタープリターセレクターをクリックして、インタープリターの設定を選択します。、利用可能なインタープリターのリストを展開し、す...

パッケージのインストール、アンインストール、アップグレード

PyCharm は、特定の Python インタープリター用の Python パッケージをインストール、アンインストール、アップグレードする方法を提供します。これは、各プロジェクトに独自のパッケージセットがあることを意味し、これは Python 依存関係管理のベストプラクティスと見なされます。デフォルトでは、PyCharm はプロジェクトパッケージの管理に pip を使用します。conda 環境では、conda パッケージマネージャーを使用できます。PyCharm では、Python パッケージツー...

Poetry 環境を構成する

Poetry は、プロジェクトの依存関係に基づいて Python 仮想環境を簡単に作成できるツールです。プロジェクトが依存するライブラリを宣言でき、Poetry がインストールして更新します。プロジェクトの依存関係は、必要なパッケージ、スクリプト、プラグイン、URL を指定する pyproject.toml ファイルに記録されます。ファイルの構造と形式の詳細については、pyproject リファレンスを参照してください。PyCharm で Poetry を使用するには、Poetry をマシンにインストー...

uv 環境を構成する

uv ツールを使用すると、Python の開発が容易になり、新しいプロジェクトのセットアップタスクが削減され、既存のプロジェクトの管理が容易になります。PyCharm で使用するには、マシンにをインストールし、特定の Python 環境を作成する必要があります。新しい Python プロジェクトの作成時にを選択すると、PyCharm は自動的に pyproject.toml ファイルを生成します。このファイルには、必要なパッケージ、スクリプト、プラグイン、URL が指定されています。ファイルの構造と...