PyCharm 2019.2ヘルプ

Pipenv環境を構成する

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

Pipenvは、確定的なビルドを生成し、作業環境のスナップショットを作成するために使用される Pipfile.lock ファイルも生成します。これは、プロジェクトの要件とパッケージのバージョンが重要な場合に、セキュリティに敏感なデプロイに特に役立ちます。pipenvの詳細については、docs.pipenv.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. どちらかの方法でPython インタープリターの追加ダイアログを開きます。

    • エディターを使用している場合、最も便利な方法はステータスバーPython インタープリター ウィジェットを使用することです: ウィジェットをクリックして、インタープリターの追加 ...を選択する

    • Ctrl+Alt+S を押すか、WindowsおよびLinuxの場合はファイル | 設定を、macOSの場合はPyCharm | 環境設定を選択して、設定/環境設定ダイアログを開きます。

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

  2. このダイアログの左側のペインで、Pipenv環境をクリックします。

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

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

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

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

Pipfile ファイルが追加されているが、インタープリターが設定されていないプロジェクトを開くと、PyCharmはPipenv環境を使用できるようにします。

Pipenv inspection

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

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

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

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

最終更新日: 2019年11月6日

関連ページ:

pipfileを使って依存関係を管理する

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

純粋なPythonプロジェクトを作成する

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

ユーザーインターフェースの概要

PyCharmでプロジェクトを開くと、デフォルトのユーザーインターフェースは次のようになります。プラグインのセットと構成設定によっては、IDEの外観と動作が異なる場合があります。エディター:フォーカス:エディターを使用してコードを読み書きします。詳しくは、エディターの基本を参照してください。ナビゲー...

設定/環境設定ダイアログ

WindowsとLinux用のmacOS用現在のプロジェクトに関連する設定はアイコンでマークされています。設定ダイアログでは、PyCharmの動作と外観を制御できます。ダイアログの左上部分にある検索フィールドを使用して、目的のオプションを見つけます。あるいは、検索ボックスにあるカテゴリの階層リスト(...

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

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

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

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