Pyenv 是一個用來控制 Python 版本的工具
不論是在升級專案的 Python 版本，還是根據不同專案切換 Python 版本，Pyenv 都是一個很方便的工具。

安裝方法

使用 Homebrew 安裝，參考官方說明：Installation
目前不支援 windows，但是有提出替代解決方案 pyenv-win

brew install pyenv

檢查使否成功安裝：

pyenv versions

安裝完之後根據使用的 Shell 設定參數

bash 使用者：

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

zsh 使用者：

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

如果上面忘記上面指令，可以透過 pyenv init 指令查看要做的事情，輸入後會顯示以下提示：

# Load pyenv automatically by appending
# the following to
# ~/.zprofile (for login shells)
# and ~/.zshrc (for interactive shells) :

export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

# Restart your shell for the changes to take effect.

可以手動加入指定檔案中，並且重新開啟終端機來讓變更生效。

使用說明

安裝指定版本

查看可安裝的 python 版本：

pyenv install -l

安裝指定版本：

以 python 3.13.5 為範例

pyenv install -v 3.13.5

查看已安裝版本：

pyenv versions

套用版本

如果同時設定多個版本的話，優先順序是：

1. shell
2. local
3. global

在當前終端機使用指定版本：

pyenv shell 3.13.5

在當前資料夾使用指定版本：

pyenv local 3.13.5

全域使用指定版本：

pyenv global 3.13.5

檢查套用結果：

python3 --version

恢復成系統預設 python 版本

pyenv global system

如果恢復系統預設不生效的話，可以先嘗試刪除檔案：/Users/{user_name}/.pyenv/version