PyCharm 2020.1ヘルプ

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 をクリックしてプロジェクト・インタープリターノードを展開し、次の環境を使用を選択し、使用可能な仮想環境のリストから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で、プロジェクト<プロジェクト名> | プロジェクト・インタープリターを選択します。 The Configure project 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仮想環境をプロジェクトインタープリターとして設定すると、使用可能なすべてのパッケージが Pipfileで定義されているソースから追加されます。パッケージは、pipの代わりにpipenvを使用して、パッケージのリストにインストール、削除、および更新されます。

設定されているPythonインタープリターのいずれに対しても、次のことができます。

最終更新日: 2020年7月2日

関連ページ:

pipfileを使用する

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

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

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

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

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

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

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

仮想環境を構成する

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