Pythonのバージョン管理：pyenvの導入と使い方
Pythonのプロジェクト開発において、複数のPythonバージョンを使い分ける必要が生じることは少なくありません。例えば、あるプロジェクトではPython 3.8が必要だが、別のプロジェクトでは最新のPython 3.11を使いたい、といった状況です。このような場合に、システム全体にインストールされているPythonバージョンを都度切り替えるのは非常に煩雑で、環境の汚染にもつながりかねません。
pyenvは、こうしたPythonのバージョン管理を効率的に行うための強力なツールです。ローカル環境に複数のPythonバージョンをインストールし、プロジェクトごとに、あるいはグローバルに、使用するPythonバージョンを簡単に切り替えることができます。これにより、プロジェクト間の依存関係の衝突を防ぎ、クリーンな開発環境を維持することが可能になります。
pyenvの導入
pyenvの導入は、オペレーティングシステムによって手順が若干異なります。ここでは、一般的なLinux/macOS環境での導入方法を中心に説明します。Windows環境については、別途WSL（Windows Subsystem for Linux）を利用するか、`pyenv-win`といった代替ツールの利用を検討することになります。
Linux/macOSでのインストール
最も簡単で推奨されるインストール方法は、pyenv-installerを利用することです。
1. **pyenv-installerのダウンロードと実行:**
ターミナルを開き、以下のコマンドを実行します。
“`bash
curl https://pyenv.run | bash
“`
このコマンドは、pyenvおよび関連プラグイン（pyenv-virtualenvなど）を自動的にダウンロードし、必要な場所にインストールします。
2. **環境変数の設定:**
インストーラーが完了すると、ターミナルに環境変数を追加するように指示が表示されます。通常、`~/.bash_profile`、`~/.zshrc`、あるいは`~/.profile`といったシェルの設定ファイルに以下の行を追加する必要があります。
“`bash
export PYENV_ROOT=”$HOME/.pyenv”
export PATH=”$PYENV_ROOT/bin:$PATH”
eval “$(pyenv init –path)”
eval “$(pyenv init -)”
“`
これらの設定を反映させるために、ターミナルを再起動するか、以下のコマンドを実行します。
“`bash
source ~/.bash_profile # または使用しているシェルの設定ファイル
“`
3. **インストールの確認:**
以下のコマンドを実行して、pyenvが正しくインストールされているか確認します。
“`bash
pyenv –version
“`
バージョン番号が表示されれば、インストールは成功です。
依存関係のインストール
pyenvで特定のPythonバージョンをビルド・インストールするには、そのバージョンをコンパイルするために必要なライブラリやツールがシステムにインストールされている必要があります。これらの依存関係は、OSのパッケージマネージャー（apt、brewなど）を使ってインストールします。
例えば、Ubuntu/Debian系では以下のコマンドで多くの依存関係をインストールできます。
“`bash
sudo apt update
sudo apt install build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev
“`
macOSでは、Homebrewを使って以下のようにインストールできます。
“`bash
brew update
brew install openssl readline sqlite3 xz zlib
“`
これらの依存関係は、インストールしたいPythonのバージョンやOSによって若干異なる場合があるため、pyenvの公式ドキュメントを参照することをお勧めします。
pyenvの使い方
pyenvの基本的な使い方は、以下のコマンド群によって行われます。
利用可能なPythonバージョンの確認
現在pyenvでインストール可能なPythonのバージョンリストを表示します。
“`bash
pyenv install –list
“`
これにより、インストールできるPythonのバージョン（CPython、Anaconda、Miniconda、PyPyなど）の候補が表示されます。
Pythonバージョンのインストール
特定のPythonバージョンをインストールします。例えば、Python 3.9.12をインストールするには、以下のコマンドを実行します。
“`bash
pyenv install 3.9.12
“`
このプロセスは、指定されたバージョンのPythonソースコードをダウンロードし、システム上でコンパイル・インストールするため、環境によっては時間がかかることがあります。
インストール済みPythonバージョンの確認
現在pyenvによってインストールされているPythonのバージョンリストを表示します。
“`bash
pyenv versions
“`
出力例：
“`
* system (set by /home/user/.pyenv/version)
3.9.12
3.10.5
“`
アスタリスク（`*`）が付いているバージョンが、現在アクティブなバージョンです。
Pythonバージョンの切り替え
Pythonのバージョンは、以下の3つのスコープで切り替えることができます。
* **グローバル（Global）:** システム全体でデフォルトとして使用されるPythonバージョンを設定します。
“`bash
pyenv global 3.9.12
“`
* **ローカル（Local）:** 特定のプロジェクトディレクトリで有効になるPythonバージョンを設定します。この設定は、`.python-version` というファイルがプロジェクトのルートディレクトリに作成され、そこにバージョン番号が記録されます。pyenvは、このファイルが存在する場合、そのプロジェクトディレクトリに入った際に自動的に指定されたバージョンに切り替えます。
“`bash
cd /path/to/your/project
pyenv local 3.10.5
“`
* **シェル（Shell）:** 現在使用しているターミナルセッション（シェル）でのみ有効なPythonバージョンを設定します。これは一時的な切り替えに便利です。
“`bash
pyenv shell 3.8.16
“`
シェルセッションを閉じると、この設定は無効になります。
現在のPythonバージョンの確認
現在アクティブになっているPythonのバージョンを確認します。
“`bash
python –version
“`
または
“`bash
pyenv version
“`
インストール済みPythonバージョンのアンインストール
不要になったPythonバージョンをアンインストールします。
“`bash
pyenv uninstall 3.9.12
“`
pyenv-virtualenvとの連携
pyenvは、仮想環境管理ツールであるpyenv-virtualenvと連携させることで、さらに強力な環境管理が可能になります。pyenv-virtualenvは、pyenvでインストールした特定のPythonバージョンをベースに、独立した仮想環境を作成・管理します。これにより、プロジェクトごとに異なるライブラリのセットを管理することができます。
pyenv-virtualenvのインストール
pyenv-installerを利用してpyenvをインストールした場合、通常はpyenv-virtualenvも一緒にインストールされます。もし別途インストールする場合は、pyenvのプラグインとしてインストールします。
仮想環境の作成
特定のPythonバージョン（例：3.9.12）をベースにした仮想環境を作成します。`my-project-env` という名前で作成する場合：
“`bash
pyenv virtualenv 3.9.12 my-project-env
“`
仮想環境の有効化・無効化
作成した仮想環境を有効にするには、`pyenv activate` コマンドを使用します。
“`bash
pyenv activate my-project-env
“`
仮想環境を無効にするには、`pyenv deactivate` コマンドを使用します。
“`bash
pyenv deactivate
“`
pyenv-virtualenvは、pyenvの`local`設定と組み合わせて使用すると非常に便利です。プロジェクトディレクトリで`pyenv local my-project-env`と設定しておけば、そのディレクトリに入った際に自動的に仮想環境が有効になります。
仮想環境のリスト表示
作成済みの仮想環境のリストを表示します。
“`bash
pyenv virtualenvs
“`
仮想環境の削除
不要になった仮想環境を削除します。
“`bash
pyenv uninstall my-project-env
“`
まとめ
pyenvは、Python開発者にとって必須とも言えるバージョン管理ツールです。複数のPythonバージョンをクリーンに管理し、プロジェクトごとに最適な環境を構築できることは、開発効率と安定性に大きく貢献します。pyenv-virtualenvと組み合わせることで、さらにきめ細やかな環境構築が可能となり、複雑なプロジェクト開発もスムーズに進めることができるでしょう。導入と基本的な使い方は比較的容易であるため、まだ利用していない方はぜひ試してみることをお勧めします。
