PyCharm 2020.2ヘルプ

Pipenv環境を構成する

Pipenvは、Pythonプロジェクトの仮想環境を作成するために必要なすべての手段を提供するツールです。パッケージをインストールまたはアンインストールすると、Pipfileファイルを通じてプロジェクトパッケージが自動的に管理されます。

Pipenvは、Pipfile.lockファイルも生成します。このファイルは、確定的なビルドを作成し、作業環境のスナップショットを作成するために使用されます。これは、プロジェクトの要件とパッケージのバージョンが重要な場合に、セキュリティが重要なデプロイに特に役立ちます。pipenvの詳細については、pipenv.kennethreitz.org/(英語)のプロジェクトドキュメントを参照してください。

PipenvとPyCharmを併用するには、いくつかの準備手順を実行する必要があります。

Pipenvをインストールする

  1. 次のコマンドを実行して、pipがシステムにインストールされていることを確認します。

    $ pip --version

    pipバージョンを示すシステム応答を受け取ることを期待するべきです。pipが見つからない場合は、インストール手順(英語)の説明に従ってインストールしてください。あるいは、http://python.org(英語)からPythonをダウンロードしてインストールすることもできます。

  2. 次のコマンドを実行して pipenv をインストールします。

    $ pip install --user pipenv

    インストールが完了すると、次のメッセージが表示されます。

    System response on successful pipenv installation
  3. 便宜上、PATH 環境変数にユーザベースのバイナリディレクトリを追加することができます。この手順をスキップすると、PyCharmはpipenv環境を追加するときにpipenv実行可能ファイルへのパスを指定するよう指示します。

    1. 次のコマンドを実行します。

      $ py -m site --user-site

      出力例は次のとおりです。

      C:\Users\jetbrains\AppData\Roaming\Python\Python37\site-packages
    2. このパスの site-packagesScripts に置き換えて、PATH 変数に追加する文字列を受け取ります。たとえば、次のようになります。

      $ setx PATH "%PATH%;C:\Users\jetbrains\AppData\Roaming\Python\Python37\Scripts"
    1. 次のコマンドを実行して、ユーザーベースのバイナリディレクトリを探します。

      $ python -m site --user-base

      出力の例は次のとおりです

      /Users/jetbrains/.local(masOS)または/home/jetbrains/.local (Linux)

    2. このパスにbinを追加して、~/.bashrcファイルに追加するための文字列を受け取ります。例:

      $ export PATH="$PATH:/Users/jetbrains/.local/bin"
    3. 次のコマンドを実行して、変更を有効にします。

      $ source ~/.bashrc
    4. bash_profilebashrcが有効になっていることを確認してください。

プロジェクトの設定で、指定したパスをいつでもpipenv実行可能ファイルに変更できます。設定/環境設定ダイアログ Ctrl+Alt+Sツール | Python 統合ツールにナビゲートし、実行可能なPipenvのパスフィールドにターゲットパスを入力します。

準備が完了したら、pipenvを使用して新規プロジェクトまたは既存プロジェクトの仮想環境を作成できます。

新しいPythonプロジェクト用にpipenvを設定する

  1. 純粋なPythonプロジェクトを作成するに従って、新しいPythonプロジェクトの作成を開始します。

  2. 新規プロジェクトダイアログで、Expand をクリックしてPython インタープリターノードを展開し、次の環境を使用を選択し、使用可能な仮想環境のリストからPipenvを選択します。

    Select Pipenv when creating a new Python project
  3. ユーザベースのバイナリディレクトリを PATH 環境変数に追加した場合、追加のオプションを設定する必要はありません:pipenv実行ファイルへのパスは自動検出されます。

    Path to the pipenve executable is autodetected
  4. タスクを完了するには、OKをクリックします。

  5. PATH 変数を変更していない場合、PyCharmはエラーメッセージPipenv実行ファイルが見つかりませんを表示します。pipenvインストール手順の説明に従って適切な実行可能パスを見つけ実行可能なPipenvフィールドにターゲット文字列を入力します(例:C:\Users\jetbrains\AppData\Roaming\Python\Python37\Scripts\pipenv.exe(Windows)または/Users/jetbrains/.local/bin/pipenv(macOS))。

    OKをクリックして変更を保存し、タスクを完了します。

また、以前に作成したプロジェクトに対してpipenvを設定することもできます。

既存のPythonプロジェクト用にpipenvを設定する

  1. Ctrl+Alt+S を押してプロジェクト設定/環境設定を開きます。

  2. 設定/環境設定ダイアログCtrl+Alt+Sで、プロジェクト<プロジェクト名> | Python インタープリターを選択します。 The Configure project interpreter アイコンをクリックして、追加を選択します。

    Selecting the Add command to create a new Python interpreter
  3. このダイアログの左側のペインで、Pipenv環境をクリックします。

    Adding a Pipenv environment
  4. ユーザベースのバイナリディレクトリを PATH 環境変数に追加した場合、追加のオプションを設定する必要はありません:pipenv実行ファイルへのパスは自動検出されます。

    Pipenv実行ファイルが見つかりませんエラーメッセージが表示された場合は、pipenvインストール手順に従って実行可能パスを見つけ、それを実行可能なPipenvフィールドに追加します。

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

すべての手順が完了すると、あなたのプロジェクトに新しいpipenv環境が設定され、Pipfileにリストされているパッケージがインストールされます。

Pipfileファイルが追加されていて、インタープリターが構成されていないプロジェクトを開く場合、PyCharmはPipenv環境を使用するように提供します。

Pipenv inspection

このオプションを選択すると、PyCharmによって自動的にpipenvが設定されます。または、Pythonインタープリターを構成するをクリックして標準ワークフローに従うこともできます。

同様に、たとえばPyCharmでPipfileファイルを使用してプロジェクトを初めて開くと、たとえば、バージョン管理からチェックアウトすると、Pipenv仮想環境が自動的に構成されます。

Pipenv仮想環境をPythonインタープリターとして設定すると、使用可能なすべてのパッケージがPipfileで定義されたソースから追加されます。パッケージは、pipではなくpipenvを介してパッケージのリストでインストール、削除、および更新されます。

構成済みのPythonインタープリター(ただしDocker-basedを除く)のいずれかについて、以下を行うことができます。

最終更新日: 2020年8月19日

関連ページ:

pipfileを使用する

Pipfileは、Pipenv仮想環境がプロジェクトの依存関係を管理するために使用する専用ファイルです。このファイルは、Pipenvを使用するために不可欠です。新規または既存のプロジェクト用にPipenv環境を作成すると、Pipfileが自動的に生成されます。ファイルが現在のプロジェクトに追加され、...

Python プロジェクトを作成します

純粋なPythonプロジェクトは、Pythonプログラミングを対象としています。プロジェクトを作成するには、次のいずれかを実行します。メインメニューから、ファイル | 新規プロジェクトを選択します。ようこそ画面で、新規プロジェクトの作成をクリックします。新規プロジェクトダイアログが開きます。新規プロ...

インタープリターパスのインストール、アンインストール、およびアップグレード

PyCharmは、選択されたインタープリターにパスを追加することを可能にします。これらのパスは環境変数に追加されます。また、PyCharmはこれらのパスのインデックスを作成し、コードのオブジェクト(たとえば、パッケージのインポート)を解決します(潜在的に)。インタープリターのパスを表示するにはプロジ...

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

PyCharmは、特定のPythonインタープリターのPythonパッケージをインストール、アンインストール、およびアップグレードする方法を提供します。デフォルトでは、PyCharmはpipを使用してプロジェクトパッケージを管理します。Conda環境では、condaパッケージマネージャーを使用できま...

仮想環境を構成する

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