コマンド リファレンス (以下のインストールとセットアップ手順):

# List all versions of python interpreters available to install:
pyenv install -l
# List all versions of CPython (the default interpreter) available to install:
pyenv install -l | grep -E '^\s*[0-9]'
# Install specified version. In this case it installs 3.12.6
pyenv install 3.12.6
# List versions installed locally:
pyenv versions
# See global version
pyenv global
# Set global version to x.x.x; in this case it sets to 3.12.6
pyenv global 3.12.6
# See local version
pyenv local
# Set global version to x.x.x; in this case it sets to 2.7.18
pyenv global 3.12.6

PyEnv の概要

さまざまな言語バージョンとインタプリタの管理は、2024 年 9 月の時点で Python の世界ではややグレーゾーンですが、もちろんコミュニティにはこの問題を回避する「非公式」ソリューションがあります。
特に優れたものの 1 つは PyEnv で、これは Ruby のバージョン管理ソリューションから多大に借用しており、これは Ruby が非常にうまく機能します。
PyEnv は基本的に、グローバル スコープとローカライズされたスコープの両方で、特定の Python バージョンまたはインタープリターをインストールおよび選択するのに役立つシェル スクリプトのコレクションです。
これは、PATH に shim のディレクトリを挿入することで機能し、Python バイナリをマップするために特定の条件に従って shim を再ハッシュします (pip のマッピング、PYTHON_VERSION 環境の切り替えなどの他の設定も同様)。
このガイドでは、MacOS と Debian ファミリーの Linux ディストリビューションに焦点を当て、bash と zsh の両方でのセットアップについて説明します。 pyenv-win はカバーされません。

PyEnv のインストール

MacOS

これは、homebrew と xcode-tools がインストールされていることを前提としています。
最初の行は、Python バージョンをインストールしてビルドするための依存関係をインストールします。
2行目はpyenv自体をインストールします。
3 行目はオプションで、brew を実行する前に pyenv ロードを追加します。これは、brew Doctor の実行時の誤検知警告を回避し、brew Python パッケージを開発している場合のエラーを回避します。これは .zshrc に配置されていることに注意してください。古いマシンでない限り、Mac ではデフォルトで zsh がすでに有効になっているはずです。古いマシンの場合は、それを .bash_profile.
に追加する必要があります。

brew install openssl readline sqlite3 xz zlib tcl-tk && \
brew install pyenv \
&& echo "alias brew='env PATH=\"${PATH//$(pyenv root)\/shims:/}\" brew'" >> ~/.zshrc

Linux (Debian ベース)

まず、依存関係をインストールします。
次に、パブリック リポジトリのクローンを $HOME/.pyenv.
に作成します。

sudo apt update && sudo apt install build-essential \
libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl git \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev && \
git clone https://github.com/pyenv/pyenv.git $HOME/.pyenv

インストール後 (MacOS と Linux の両方)

これを関連するシェル設定ファイルに追加します。bash を使用している場合は .bash_profile、zsh を使用している場合は .zshrc です。不明な場合は、echo $SHELL でどれを調べてください。

## pyenv configs
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"

if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init -)"
fi

最後に、ターミナル環境を更新して、exec "$SHELL" による変更を確認します。

このセットアップの後、Python (Python3 ではありません!) は、pyenv でセットアップされた Python バージョンにマッピングされます。
次に、Python バージョンをインストールし (上記のコマンド リファレンスを参照)、それをグローバル バージョンとして設定することをお勧めします。
python --version ですべてが機能することを確認し、インストールされているバージョンが選択したバージョンと一致するかどうかを確認します。そうでない場合は、システムのデフォルトを指している可能性が高いため、以下の手順のいずれかを実行しなかった可能性があります (おそらく、ターミナルを更新し、何をすべきかわからない場合はターミナル ウィンドウを閉じて再度開く部分です) ).

より健全な Python バージョン管理を楽しんでください!