PyCharm 2026.1 Help

virtualenv 環境を構成する

PyCharm では、 virtualenv ツールを使用してプロジェクト固有の分離された 仮想環境を作成できます。 仮想環境の主な目的は、他の Python プロジェクトに関係なく、特定のプロジェクトの設定と依存関係を管理することです。 virtualenv ツールは PyCharm にバンドルされているため、インストールする必要はありません。

virtualenv 環境を作成する

  1. 次のいずれかを実行します:

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

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

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

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

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

    新しい virtualenv 環境
    新しい仮想環境を生成する
    1. 環境タイプのリストから Virtualenv を選択します。

    2. リストから基本インタープリターを選択するか、 ベースインタープリターを選択 をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

    3. ロケーション フィールドに新しい仮想環境の場所を指定するか、 仮想環境のロケーション をクリックしてファイルシステム内の場所を参照します。 新しい仮想環境のディレクトリは空である必要があります。

    4. マシン上のグローバル Python にインストールされているすべてのパッケージを、これから作成する仮想環境に追加する場合は、 ベースインタープリターからパッケージを継承する チェックボックスを選択します。 このチェックボックスは、 --system-site-packages オプションに virtualenv ツールの対応しています。

    5. PyCharm で Python インタープリターを作成する際にこの環境を再利用したい場合は、 すべてのプロジェクトで使用可能にする チェックボックスを選択します。

    既存の virtualenv 環境
    既存の仮想環境を選択
    • 環境タイプのリストから Python を選択します。

    • リストから必要なインタープリターを選択します。

      必要なインタープリターがリストにない場合は、 をクリックし、必要な Python 実行可能ファイル (たとえば、macOS の場合は venv/bin/python 、Windows の場合は venv\Scripts\python.exe ) を参照します。

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

  4. タスクを完了するには、 OK をクリックしてください。

必要な数の仮想環境を作成できます。 互いから簡単に伝えるには、別の名前を使用します。

PyCharm は、プロジェクトの要件に基づいてプロジェクト用の仮想環境を作成できます。

プロジェクト要件を使用して仮想環境を作成する

  1. requirements.txt または setup.py ファイルを含むソースファイルのある任意のディレクトリを開きます。メインメニューから ファイル | オープン を選択し、ディレクトリを選んでください。

  2. このプロジェクト用に仮想環境が作成されていない場合、PyCharm が作成を提案します。

    プロジェクトインタープリターを設定するためのオプションに関する警告
  3. requirements.txt を使用して仮想環境を作成する をクリックしてください。

    Requirements.txt ファイルを使用して仮想環境を作成する
  4. 提案されたオプションをそのまま使用するか、環境の場所またはベースとなる Python インタープリターを指定します。 タスクを完了するには、 OK をクリックしてください。

OK をクリックすると、PyCharm は環境を作成し、必要なすべてのパッケージをインストールします。 完了したら、通知ポップアップを参照してください。

環境が作成されます

仮想環境を作成する提案を無視した場合、PyCharm はプロジェクト用の Python インタープリターを作成しません。 そのため、 .py ファイルを開くたびに、プロジェクトインタープリターを構成するためのオプションを含む警告が表示されます。

このアプローチは、環境のベースとなっている Python のバージョンを、たとえば 3.5 から 3.9 にアップグレードする場合に特に役立ちます。 新しいベースインタープリターを指定し、 requirements.txt を使用して、必要なパッケージがすべてインストールされていることを確認できます。

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

新しい仮想環境を作成したら、それを他のプロジェクトで再利用できます。 既存の環境を Python インタープリターとして設定する方法について詳しくはこちらをご覧ください。

2026 年 6 月 1 日