PyCharm 2020.2ヘルプ

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

PyCharmのPythonインタープリター

PyCharmでPythonコードを使用するには、少なくとも1つのインタープリターを構成する必要があります。Pythonインタープリターを1つだけ使用することに限定されません。いくつかを実装することができます。その際、特定のプロジェクトに使用するインタープリターを選択します。

Python インタープリターを構成するときは、システム内のPython実行可能ファイルへのパスを指定する必要があります。Pythonインタープリターを構成する前に、Pythonをダウンロード(英語)してシステムにインストールし、そのパスを知っていることを確認する必要があります。同じPython実行可能ファイルに基づいて、複数のPythonインタープリターを作成できます。これは、さまざまなタイプのアプリケーションを開発するためにさまざまな仮想環境を作成する必要がある場合に役立ちます。例:Python 3.6に基づいて1つの仮想環境を作成してDjangoアプリケーションを開発し、同じPython 3.6に基づいて別の仮想環境を作成して科学ライブラリを操作できます。

以下を構成できます。

PyCharm Professionalを使用すると、リモート環境でPythonコードを実行するようにインタープリターを構成することもできます。

Pythonインタープリターは以下のレベルで設定できます:

  • 現在のプロジェクト : 現在選択されているPythonインタープリターが現在のプロジェクトに使用されます。

    このレベルでのPythonインタープリターの構成について、以下で説明します。新しいインタープリターを作成するか、既存のインター プリターのいずれかを使用できます。

  • 新規プロジェクト : 選択したPythonインタープリターがデフォルトのプロジェクトの代わりに新しいプロジェクトに使用されます。

    セクションPython プロジェクトを作成しますを参照してください。

新しいPythonインタープリターの作成

現在のプロジェクトに新しいインタープリターを追加するには:

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

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

    Selecting the Add command to create a new Python interpreter
  3. 追加するインタープリタータイプを選択して、特定の設定を実行します。

    1. Python インタープリターの追加ダイアログの左側のペインでVirtualenv 環境を選択します。以下のアクションは、仮想環境が以前に存在していたかどうかによって異なります。

      creating a virtual environment

      新しい環境が選択されている場合:

      1. テキストフィールドに新しい仮想環境の場所を指定するか、Virtual environment location をクリックしてファイルシステム内の場所を探します。新しい仮想環境を配置するディレクトリは空でなければならないことに注意してください。

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

        PyCharmがマシン上でPythonを検出しない場合、python.orgから最新のPythonバージョンをダウンロードするか、Python実行可能ファイルへのパスを指定する(非標準のインストールの場合)という2つのオプションを提供します。

        Downloading Python when creating a virtual env

      3. グローバルサイトパッケージディレクトリを継承する場合は、グローバル site-packages を継承するチェックボックスを選択します。このチェックボックスは、virtualenv(英語)ツールの --system-site-packages オプションに対応しています。

      4. 必要に応じてすべてのプロジェクトで使用可能にするチェックボックスを選択してください。

      既存の環境が選択されている場合:

      1. インタープリターリストを展開し、既存のインタープリターを選択します。または、Select an interpreter をクリックし、ファイルシステム内のPython実行可能ファイルへのパスを指定します(例:C:\Python36\python.exe)。

      2. 必要に応じて、チェックボックスすべてのプロジェクトで使用可能にするを選択してください。

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

    詳細は仮想環境を構成するを参照してください。

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

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

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

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

    詳細はPipenv環境を構成するを参照してください。

    1. Python インタープリターの追加ダイアログの左側のペインでConda 環境を選択します。以下のアクションは、Conda環境が以前に存在していたかどうかによって異なります。

      新しい環境が選択されている場合:

      1. テキストフィールドに新しいConda環境の場所を指定するか、Conda environment location をクリックしてファイルシステム内の場所を探します。新しいConda環境を配置するディレクトリは空でなければならないことに注意してください。

      2. リストからPythonのバージョンを選択します。

      3. テキストフィールドにConda実行可能ファイルの場所を指定するか、Conda executable location をクリックしてCondaインストールディレクトリ内の場所を見つけます。基本的に、マシンにCondaをインストールするときに使用したパスを探しています。

      4. 必要に応じてすべてのプロジェクトで使用可能にするチェックボックスを選択してください。

      既存の環境が選択されている場合:

      1. インタープリターリストを展開し、既存のインタープリターを選択します。または、Select an interpreter をクリックし、ファイルシステム内のConda実行可能ファイルへのパスを指定します(例:C:\Users\jetbrains\Anaconda3\python.exe)。

      2. 必要に応じて、チェックボックスすべてのプロジェクトで使用可能にするを選択してください。

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

    詳細はConda仮想環境を構成するを参照してください。

    1. Python インタープリターの追加ダイアログの左側のペインでシステム・インタープリターを選択します。

      Adding a system interpreter

    2. インタープリターフィールドに、必要なインタープリター実行可能ファイルへの完全修飾パスを入力するか、the Browse button をクリックして表示されるPython インタープリターの選択ダイアログで、目的のPython実行可能ファイルを選択してOKをクリックします。

      PyCharmがマシン上でPythonを検出しない場合、python.orgから最新のPythonバージョンをダウンロードするか、Python実行可能ファイルへのパスを指定する(非標準のインストールの場合)という2つのオプションを提供します。

      Downloading Python when installing the system interpreter

      システムインタープリターのパッケージをインストール、削除、およびアップグレードするには管理者権限が必要です。インテンションアクションを介してインタープリターパッケージをインストールしようとすると、次のエラーメッセージが表示されることがあります。

      System Interpreter warning message
      プロンプトが表示されたら、プロジェクトに仮想環境を使用することを検討してください。

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

    詳細はシステムインタープリターを設定するを参照してください。

    これはProfessional機能です。PyCharmProfessionalをダウンロードして試してください。

    1. Python インタープリターの追加ダイアログの左側のペインで、SSHインタープリターをクリックします。

    2. 右側のペインで新規サーバー構成を選択し、サーバー情報(ホスト、ポート、およびユーザー名)を指定します。

      adding an interpreter via SSH

      または、既存サーバー構成を選択して、使用可能なデプロイ構成をリストから選択することもできます。

      Existing SSH configuration

      必要に応じて、the Browse button をクリックして、選択したデプロイ構成の接続設定マッピング、および除外パスを確認します。インタープリターの設定を続行するには、次へをクリックします。

    3. 次のダイアログ・ウィンドウで、ターゲット・サーバーに接続するための認証の詳細を入力します。

      specifying authentication details

      パスワードまたはキー・ペア (OpenSSLまたはPuTTY)を選択し、パスワードまたはパスフレーズを入力します。キー・ペア (OpenSSLまたはPuTTY)を選択した場合は、以下を指定します。

      次へをクリックして、最終的な設定手順に進みます。

    4. 次のダイアログウィンドウで、目的のPythonインタープリターへのパスを確認します。デフォルトを受け入れるか、別のデフォルトを指定できます。ローカルプロジェクトとサーバー間のパスマッピングを構成する必要があります。これを行うには、フォルダーの同期フィールドの横にある the Browse button をクリックし、ローカルプロジェクトフォルダーへのパスとリモートサーバー上のフォルダーへのパスを入力します。

      Setting SSH mappings

      最低のチェックボックスを選択して、リモートサーバーへのローカル変更の自動アップロードを有効にすることもできます。

    詳細はSSHを使用してインタープリターを構成するを参照してください。

    これはProfessional機能です。PyCharmProfessionalをダウンロードして試してください。

    1. Python インタープリターの追加ダイアログの左側のペインで、Vagrantをクリックします。

      Add an interpreter

    2. フィールドVagrant インスタンス・フォルダーの横にある参照ボタン the Browse button をクリックし、目的のVagrantインスタンスフォルダーを指定します。

      この結果、VagrantホストURLへのリンクが表示されます。

    3. Python インタープリター・パスフィールドには、目的のPython実行可能ファイルへのパスが表示されます。デフォルトを受け入れるか、別のものを指定することができます。

    4. OKをクリックします。設定済みのリモートインタープリターがリストに追加されます。

    詳細はVagrantを使用してインタープリターを構成するを参照してください。

    これはProfessional機能です。PyCharmProfessionalをダウンロードして試してください。

    1. ダイアログの左側のペインで、WSLをクリックします。

      Adding a WSL interpreter
    2. Linuxディストリビューションを選択し、選択したLinuxディストリビューションのpython実行可能ファイルへのパスを指定します。通常、wsl.exeを探す必要がありますが、デフォルト以外のWSLディストリビューションを指定できます。

    詳細はWSLを使用してインタープリターを構成するを参照してください。

    これはProfessional機能です。PyCharmProfessionalをダウンロードして試してください。

    表示されるダイアログで、Dockerオプションを選択し、ドロップダウンリストからDockerサーバーを選択し(サーバーがない場合は新規...をクリック)、イメージ名を指定します。

    Pythonインタープリターのパスはデフォルト値を持つ必要があります:

    Choose a docker

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

      詳細はDockerを使用してインタープリターを構成するを参照してください。

      これはProfessional機能です。PyCharmProfessionalをダウンロードして試してください。

      表示されるダイアログで、Docker Composeオプションを選択し、ドロップダウンリストからDockerサーバー、Docker Composeサービス(ここでは web)、設定ファイル(ここでは docker-compose.yml)、およびイメージ名(ここでは python)を選択します。

      webを選んだのはなぜですか?この選択は、Docker-Composeベースのインタープリターを構成した後、選択したコンテナーの動作を変更する通常の実行構成を作成できるようになるという事実によって説明されます。コンテナー内のコードをデバッグする場合は、ここで選択する必要があります。作成ファイル内の他のすべてのコンテナーは、常にこのファイルとともに起動されますが、PyCharmからの動作に影響を与えることはできません。コマンドラインからコマンド docker-compose up を起動した場合と同じように動作します。

      次に、PyCharmがあなたのDocker-Compose設定を開始してスキャンしてインデックスを作成するのを待ちます:

      Configure remote Python interpreter

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

        詳細はDocker Composeを使用してインタープリターを構成するを参照してください。

      リモート Pythonインタープリターが追加されると、まずPyCharmヘルパーがリモートホストにコピーされます。PyCharmヘルパーは、パッケージングタスク、デバッガ、テスト、その他のPyCharm機能をリモートで実行するために必要です。次に、バイナリライブラリのスケルトンが生成され、ローカルにコピーされます。また、すべてのPythonライブラリソースは、リモートホスト上のPythonパスから収集され、生成されたスケルトンとともにローカルにコピーされます。解決と補完が正しく機能するためには、スケルトンとすべてのPythonライブラリソースをローカルに格納する必要があります。PyCharmは、リモートを実行するたびにリモートヘルパーのバージョンを確認するため、PyCharmバージョンを更新すると、新しいヘルパーが自動的にアップロードされ、リモートインタープリターを再作成する必要はありません。SFTPサポートは、ヘルパーをサーバーにコピーするために必要です。

      既存のPythonインタープリターの設定

      Python インタープリター ウィジェットを使用するか、プロジェクト設定/環境設定で、いつでもPythonインタープリターを切り替えることができます。

      Pythonインタープリターウィジェットを使用してPythonインタープリターを変更する

      • Python インタープリターウィジェットはステータスバーにあります。これは、Pythonインタープリターを切り替える最も便利で迅速な方法です。それをクリックして、ターゲットのインタープリターを選択するだけです。

      Project interpreter widget

      プロジェクト設定でPythonインタープリターを変更する

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

        プロジェクト<プロジェクト名> | Python インタープリターを選択します。

      2. 利用可能なインタープリターのリストを展開してすべて表示リンクをクリックしてください。または、The Configure project interpreter アイコンをクリックしてすべて表示を選択します。

        Show all available interpreters

      3. 目的のインタープリターを選択してください。

        View interpreters

        PyCharmが古いPythonバージョンのサポートを停止すると、対応するPythonインタープリターはサポートされないものとしてマークされます。

      4. 必要に応じて、編集をクリックして代わりのインタープリター名を入力することもできます。

        Changing interpreter's name

        名前フィールドで指定されたPythonインタープリター名は、使用可能なインタープリターのリストに表示されるようになります。変更を適用するには、OKをクリックします。

      デフォルトのインタープリターを設定する

      PyCharmでは、新しく作成されたすべてのプロジェクトに自動的に設定されるインタープリターを指定できます。

      1. メインメニューから、新規プロジェクトの設定 | 新しいプロジェクトの設定(WindowsおよびLinux)または新規プロジェクトの設定 | 新しいプロジェクトの設定(macOS)を選択します。

      2. Python インタープリター設定を選択します。次に、Python インタープリターリストの既存のインタープリターを New interpreter をクリックして選択し、新しいインタープリター追加します。OKをクリックして変更を保存します。

        この変更は、PyCharmで新しく作成されたすべてのプロジェクトに有効になります。

      インタープリターパッケージの管理

      インタープリターごとに、Pythonパッケージをインストール、アップグレード、および削除できます。デフォルトでは、PyCharmはpipを使用してプロジェクトパッケージを管理します。Conda環境では、Condaパッケージマネージャーを使用できます。

      Managing packages

      PyCharmはパッケージのステータスをスマートに追跡し、現在インストールされているパッケージバージョン(列バージョン)と最新の使用可能なバージョン(列最新バージョン)の数を表示することにより、古いバージョンを認識します。新しいバージョンのパッケージが検出されると、PyCharmはそれを矢印 New version is available でマークし、それをアップグレードすることを提案します。

      デフォルトでは、最新バージョン列にはパッケージの安定バージョンのみが表示されます。最新の利用可能なバージョンの範囲をプレリリースバージョン( ベータ版リリース候補など)に拡張する場合は、初期リリースを表示をクリックします。

      一度にいくつかのパッケージをアップグレードすることができます。Cmd(macOS)またはCtrl(UnixまたはWindows)を押したままにして、パッケージの一覧でいくつかの項目を選択するために左クリックし、 アップグレードをクリックします。

      詳細な手順を参照してください。

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

      関連ページ:

      Python

      PyCharmでPythonスクリプトを開発するには、Pythonをダウンロードしてインストールし、少なくとも1つのPython インタープリターを構成します。Windowsユーザーの場合、Windows用Pythonをインストールすることをお勧めします。サポートされるバージョン:Python 2:...

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

      PyCharmでPythonコードを使用するには、少なくとも1つのインタープリターを構成する必要があります。システムインタープリターは、Pythonインストールに付属するものです。すべてのPythonスクリプトにのみ使用するか、Python仮想環境の基本インタープリターとして使用できます。システムP...

      仮想環境を構成する

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

      Pipenv環境を構成する

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

      Dockerを使用してインタープリターを構成する

      導入:PyCharmとDockerの統合により、Dockerコンテナーにデプロイされたさまざまな構成の開発環境でアプリケーションを実行できます。前提条件:次の前提条件が満たされていることを確認してください。ページDockerドキュメントに記載されているように、Dockerがインストールされています。...

      Docker Composeを使用してインタープリターを構成する

      前提条件:次の前提条件が満たされていることを確認してください。インターネット接続が安定しています。Dockerで操作するには、busyboxイメージがマシンで使用可能である必要があります。PyCharmがをダウンロードして実行できるように、インターネット接続が安定していることを確認してください。Do...