PyCharm 2025.1 ヘルプ

仮想環境を構成する

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

virtualenv 環境を作成する

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

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

    • Ctrl+Alt+S を押して設定を開き、プロジェクト: <プロジェクト名> | Python インタープリターに移動します。

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

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

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

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

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

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

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

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

    既存の仮想環境
    Select existing virtualenv environment

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

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

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

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

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

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

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

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

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

    Warning with options for configuring a project interpreter
  3. requirements.txt を使用して仮想環境を作成するをクリックします。

    Create a virtual environment using the requirements.txt file
  4. 提案されたオプションを保持するか、環境の場所またはベース Python インタープリターを指定します。OK をクリックしてタスクを完了します。

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

The environment is created

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

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

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

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

関連ページ:

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

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

Python

PyCharm で Python スクリプトを開発するには:Python をダウンロードしてインストールします。少なくとも 1 つの Python インタープリターを構成します。Windows ユーザーの場合、Windows 用 Python をインストールすることをお勧めします。サポートされるバージョン:Python 2: バージョン 2.7、Python 3: バージョン 3.6 からバージョン 3.14 まで、次の機能は、Python 3.13 サポートの一部として使用できます。PEP 696...

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

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

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

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

Pipenv 環境を構成する

Pipenv は、Python プロジェクトの仮想環境を作成するために必要なすべての手段を提供するツールです。パッケージをインストールまたはアンインストールすると、Pipfile ファイルを介して自動的にプロジェクトパッケージが管理されます。Pipenv は、確定的なビルドを生成し、作業環境のスナップショットを作成するために使用される Pipfile.lock ファイルも生成します。これは、プロジェクトの要件とパッケージのバージョンが重要である場合、セキュリティに敏感なデプロイにとって特に役立つ可能性が...