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

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

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

ここでは、場所「/usr/bin/python +」によって証明されるように、すべてのユーザーが「 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 *でビルドの依存関係をインストールする場合は、次を使用できます。

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

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

このコマンドは、https://brew.sh/[Homebrew]に依存し、macOSユーザーのいくつかの依存関係をインストールします。

ヒント： Mojave以降（10.14以降）を実行する場合は、https://developer.apple.com/documentation/xcode_release_notes/xcode_10_release_notes#3035624 [追加のSDKヘッダー]もインストールする必要があります。

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

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

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

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

このコマンドは、パッケージマネージャーとしてhttps://wiki.alpinelinux.org/wiki/Alpine_Linux_package_management [+ apk +]を使用し、AlpineにPythonのすべてのビルド依存関係をインストールします。

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

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

*注意：*上記のコマンドはhttps://github.com/pyenv/pyenv-installer/blob/master/bin/pyenv-installer[pyenv-installer script]をダウンロードしてローカルで実行するのと同じです。 そのため、実行しているものを正確に確認したい場合は、自分でファイルを表示できます。 または、本当にスクリプトを実行したくない場合は、https://github.com/pyenv/pyenv#basic-github-checkout [手動インストール手順]をチェックアウトできます。

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

出力はシェルに基づきます。 しかし、指示に従って + pyenv +`をパスに追加し、 `+ pyenv +/`+ pyenv-virtualenv +`自動補完を初期化する必要があります。 これを行ったら、シェルをリロードする必要があります。

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

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

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

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

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

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

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

これは驚くかもしれませんが、これが `+ pyenv `の仕組みです。 ` pyenv `は自分自身を ` PATH +`に挿入し、OSの観点から_呼び出される実行可能ファイルです。 実際のパスを表示する場合は、次を実行できます。

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

*プロのヒント：*インストールした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がインストールされていることだけでなく、 + system + Pythonアクティブです。 現在のアクティブバージョンのみを考慮する場合は、次のコマンドを使用できます。

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

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

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

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

このコマンドは、 `〜/.pyenv/version +`を ` 3.6.8 +`に設定します。 詳細については、link：＃specifying-your-python-version [Pythonバージョンの指定]のセクションを参照してください。

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

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

`+ shell `コマンドは、シェル固有のPythonバージョンを設定するために使用されます。 たとえば、Pythonの ` 3.8-dev +`バージョンをテストする場合、これを実行できます。

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

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

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

`+ <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 +`が行っていることです。