PyCharm 2024.2 ヘルプ

仮想環境を構成する

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

virtualenv 環境を作成する

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

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

    • Ctrl+Alt+S を押して設定を開き、プロジェクト: <プロジェクト名> | Python インタープリターに移動します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。

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

  2. ローカルインタープリターを追加するを選択します。

  3. Python インタープリターの追加ダイアログの左側のペインで Virtualenv 環境を選択します。

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

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

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

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

    既存の仮想環境
    • リストから目的のインタープリターを選択します。

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

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

  5. タスクを完了するには、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 ファイルを開くたびに、プロジェクトインタープリターを構成するためのオプションを示す警告が表示されます。

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

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

新しい仮想環境を作成したら、他のプロジェクトで再利用できます。Python インタープリターとして既存の環境をセットアップする方法の詳細を参照してください。

関連ページ:

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

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

Python

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

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

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

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

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

システムインタープリターを設定する

PyCharm で Python コードを使用するには、少なくとも 1 つのインタープリターを構成する必要があります。システムインタープリターは、Python インストールに付属するものです。すべての Python スクリプトにのみ使用するか、Python 仮想環境の基本インタープリターとして使用できます。システムインタープリターを設定する Python をコンピューターにダウンロードしてインストールしたことを確認してください。Microsoft ストアから Windows に Python をインス...

Pipenv 環境を構成する

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