pyenvを使用して複数のPythonバージョンを管理する

「システムPython」は、オペレーティングシステムにインストールされているPythonです。 MacまたはLinuxを使用している場合、デフォルトでは、ターミナルにpythonと入力すると、優れたPythonREPLが得られます。

それでは、なぜそれを使用しないのですか？ それを見る1つの方法は、このPythonが実際にオペレーティングシステムに対してbelongsであるということです。 結局のところ、それはオペレーティングシステムと共にインストールされています。 これは、whichを実行したときにも反映されます。

ここで、pythonは、その場所/usr/bin/pythonから明らかなように、すべてのユーザーが利用できます。 おそらく、これはあなたが望むPythonのバージョンでもありません：

システムPythonにパッケージをインストールするには、sudo pip installを実行する必要があります。 これは、Pythonパッケージをグローバルにインストールしているためです。これは、別のユーザーが来て、少し古いバージョンのパッケージをインストールしたい場合に現実的な問題です。

同じパッケージの複数のバージョンに関する問題は、あなたに忍び寄って、あなたがそれを最も期待しないときに噛む傾向があります。 この問題が発生する一般的な方法の1つは、人気のある安定したパッケージが突然システムで誤動作することです。 数時間のトラブルシューティングとグーグル検索の後、間違ったバージョンの依存関係をインストールしたことがあり、それが1日を台無しにしている場合があります。

Pythonのバージョンが/usr/local/bin/python3にインストールされている場合でも、安全ではありません。 上記と同じ権限と柔軟性の問題が発生します。

さらに、OSにインストールされているPythonのバージョンを実際に制御することはできません。 Pythonの最新機能を使用したい場合、たとえばUbuntuを使用している場合は、運が悪いかもしれません。 デフォルトのバージョンは古すぎる可能性があるため、新しいOSがリリースされるまで待つ必要があります。

最後に、一部のオペレーティングシステムは実際にパッケージ化されたPythonを操作に使用します。 yumを例にとると、Pythonを多用して仕事をします。 Pythonの新しいバージョンをインストールし、それをユーザースペースにインストールすることに注意しないと、OSを使用する能力に重大な損害を与える可能性があります。

次に注目すべき論理的な場所は、パッケージマネージャーです。 apt、yum、brew、またはportなどのプログラムが典型的な次のオプションです。 結局のところ、これはほとんどのパッケージをシステムにインストールする方法です。 残念ながら、パッケージマネージャーを使用しても同じ問題がいくつか見つかります。

デフォルトでは、パッケージマネージャーはパッケージをユーザー空間ではなくグローバルシステム空間にインストールする傾向があります。 繰り返しますが、これらのシステムレベルパッケージは開発環境を汚染し、ワークスペースを他のユーザーと共有することを困難にします。

繰り返しますが、インストールできるPythonのバージョンを制御することはできません。 確かに、いくつかのリポジトリはより多くの選択肢を提供しますが、デフォルトでは、特定のベンダーが特定の日にどのバージョンのPythonを使用しているのかを見ています。

パッケージマネージャーからPythonをインストールする場合でも、パッケージを作成していて、Python 3.4-3.7でサポートおよびテストしたい場合はどうなるかを検討してください。

python3と入力すると、システムで何が起こりますか？ 異なるバージョン間でどのようにすばやく切り替えますか？ あなたは確かにそれを行うことができますが、それは退屈であり、エラーを起こしやすいです。 PyPy、Jython、またはMinicondaが必要な場合は、パッケージマネージャーがうまくいかない可能性があることを忘れないでください。

これらの制約を念頭に置いて、Pythonバージョンを簡単かつ柔軟にインストールおよび管理できる基準をまとめましょう。

pyenvを使用すると、これらすべてのことなどを実行できます。

pyenvはソースからPythonをビルドします。つまり、実際にpyenvを使用するには、ビルドの依存関係が必要になります。 ビルドの依存関係はプラットフォームによって異なります。 Ubuntu/Debianを使用していて、ビルドの依存関係をインストールする場合は、次を使用できます。

これは、Aptを使用してすべてのビルド依存関係をインストールします。 これを実行すると、Debianシステムに移行する準備が整います。

Fedora/CentOS/RHELを使用する場合は、yumを使用してビルドの依存関係をインストールできます。

このコマンドは、yumを使用してPythonのすべてのビルド依存関係をインストールします。

macOSユーザーは、次のコマンドを使用できます。

このコマンドはHomebrewに依存し、macOSユーザーのいくつかの依存関係をインストールします。

Tip: Mojave以降（10.14+）を実行している場合は、additional SDK headersもインストールする必要があります。

更新してくれたRodrigo Vieraに感謝します。

代わりにopenSUSEを使用している場合は、次を実行します。

このコマンドでも、システムのすべてのPythonビルドの依存関係がインストールされます。

最後に、Alpineユーザーの場合、これを使用できます。

このコマンドは、パッケージマネージャーとしてapkを使用し、Pythonのすべてのビルド依存関係をAlpineにインストールします。

ビルドの依存関係をインストールしたら、pyenv自体をインストールする準備が整います。 pyenv-installer projectを使用することをお勧めします：

これにより、pyenvが、便利ないくつかのプラグインとともにインストールされます。

Note:上記のコマンドは、pyenv-installer scriptをダウンロードしてローカルで実行するのと同じです。 そのため、実行しているものを正確に確認したい場合は、自分でファイルを表示できます。 または、本当にスクリプトを実行したくない場合は、manual installation instructions.をチェックアウトできます。

実行の終了時に、次のようなものが表示されるはずです。

出力はシェルに基づきます。 ただし、指示に従ってパスにpyenvを追加し、pyenv /pyenv-virtualenvのオートコンプリートを初期化する必要があります。 これを行ったら、シェルをリロードする必要があります。

それでおしまい。 これで、pyenvと4つの便利なプラグインがインストールされました。

前述のように、pyenvはソースからPythonを構築することで機能します。 インストールした各バージョンは、pyenvのルートディレクトリに適切に配置されています。

すべてのバージョンはここにあります。 これらのバージョンを削除するのは簡単なので、これは便利です。

もちろん、pyenvは、特定のPythonバージョンをアンインストールするコマンドも提供します。

いくつかの異なるPythonバージョンをインストールしたので、それらの使用方法の基本を見てみましょう。 まず、使用可能なPythonのバージョンを確認します。

*は、systemPythonバージョンが現在アクティブであることを示します。 また、これはルートpyenvディレクトリ内のファイルによって設定されていることにも気付くでしょう。 これは、デフォルトでは、まだシステムPythonを使用していることを意味します。

whichを使用してこれを確認しようとすると、次のように表示されます。

これは意外かもしれませんが、これがpyenvの動作方法です。 pyenvはそれ自体をPATHに挿入し、OSの観点からはisは呼び出される実行可能ファイルを挿入します。 実際のパスを表示する場合は、次を実行できます。

たとえば、バージョン2.7.15を使用する場合は、globalコマンドを使用できます。

Pro Tip:インストールしたPythonのバージョンが正しく機能していることを確信するための優れた方法は、組み込みのテストスイートを実行することです。

これにより、インストールを検証する多くの内部Pythonテストが開始されます。 キックバックして、テストが成功するのを見るだけです。

Pythonのシステムバージョンをデフォルトとして使用したい場合は、次を実行できます。

Pythonの異なるバージョンを簡単に切り替えることができるようになりました。 これは始まりにすぎない。 切り替えたいバージョンが多数ある場合、これらのコマンドを一貫して入力するのは面倒です。 このセクションでは基本について説明しますが、より良いワークフローはworking with multiple environments.で説明されています。

上記のinstallコマンドはすでに見ました。 このコマンドを使用して、特定のバージョンのPythonをインストールできます。 たとえば、3.6.8をインストールする場合は、次を使用します。

出力には、pyenvがPythonをダウンロードしてインストールしていることが示されています。 使用する可能性のある一般的なフラグの一部は次のとおりです。

versionsコマンドは、現在インストールされているすべてのPythonバージョンを表示します。

この出力は、2.7.15、3.6.8、3.8-dev、およびsystem Pythonがインストールされていることを示しているだけでなく、systemPythonがアクティブであることも示しています。 現在のアクティブバージョンのみを考慮する場合は、次のコマンドを使用できます。

このコマンドはversionsに似ていますが、現在アクティブなPythonバージョンのみを表示します。

whichコマンドは、システム実行可能ファイルへのフルパスを決定するのに役立ちます。 pyenvはシムを使用して機能するため、このコマンドを使用すると、実行可能ファイルpyenvへのフルパスが実行されていることを確認できます。 たとえば、pipがインストールされている場所を確認したい場合は、次のように実行できます。

出力には、pipの完全なシステムパスが表示されます。 これは、コマンドラインアプリケーションをインストールしたときに役立ちます。

globalコマンドは、Pythonのグローバルバージョンを設定します。 これは他のコマンドで上書きできますが、デフォルトで特定のPythonバージョンを使用するのに役立ちます。 デフォルトで3.6.8を使用したい場合は、次のように実行できます。

このコマンドは、~/.pyenv/versionを3.6.8に設定します。 詳細については、specifying your Python versionのセクションを参照してください。

localコマンドは、アプリケーション固有のPythonバージョンを設定するためによく使用されます。 これを使用して、バージョンを2.7.15に設定できます。

このコマンドは、現在のディレクトリに.python-versionファイルを作成します。 ご使用の環境でpyenvがアクティブになっている場合、このファイルによってこのバージョンが自動的にアクティブ化されます。

shellコマンドは、シェル固有のPythonバージョンを設定するために使用されます。 たとえば、Pythonの3.8-devバージョンをテストする場合は、次のようにします。

このコマンドは、PYENV_VERSION環境変数を設定して指定されたバージョンをアクティブにします。 このコマンドは、アプリケーションまたはグローバル設定を上書きします。 バージョンを非アクティブ化する場合は、--unsetフラグを使用できます。

仮想環境の作成は単一のコマンドです：

技術的には、<python_version>はオプションですが、使用しているPythonのバージョンを確認できるように、常に<python_version>を指定することを検討する必要があります。

<environment_name>は、環境を分離しておくための単なる名前です。 環境にプロジェクトと同じ名前を付けることをお勧めします。 たとえば、myprojectで作業していて、Python 3.6.8に対して開発したい場合は、次のように実行します。

出力には、いくつかの追加のPythonパッケージ、つまりwheel、pip、およびsetuptoolsがインストールされていることを示すメッセージが含まれています。 これは厳密に便宜上のものであり、各仮想環境に対してより完全な機能を備えた環境をセットアップするだけです。

仮想環境を作成したら、次はそれを使用してください。 通常、次を実行して環境をアクティブ化する必要があります。

以前にpyenv localコマンドを見たことがありますが、今回はPythonのバージョンを指定する代わりに、環境を指定します。 これにより、現在の作業ディレクトリに.python-versionファイルが作成され、環境でeval "$(pyenv virtualenv-init -)"を実行したため、環境が自動的にアクティブ化されます。

これを確認するには、次を実行します。

myprojectという新しいバージョンが作成され、python実行可能ファイルがそのバージョンを指していることがわかります。 この環境が提供する実行可能ファイルを見ると、同じことがわかります。 たとえば、pip：

シェルで実行するようにeval "$(pyenv virtualenv-init -)"を構成しなかった場合は、次の方法でPythonバージョンを手動でアクティブ化/非アクティブ化できます。

上記は、.python-versionファイルが含まれているディレクトリに出入りするときにpyenv-virtualenvが実行していることです。