本文將介紹如何使用 pyenv 和 pyenv-virtualenv——兩款強大的工具，能幫助您輕鬆管理多個 Python 版本和虛擬環境。我們將涵蓋 Mac 和 Linux 等各平台的安裝說明，並討論這些工具最常用的功能。讀完本文，您將對如何在開發工作流程中有效使用這些工具有扎實的理解。

I. 概述

pyenv 是一款強大的 Python 版本管理工具，讓您能輕鬆安裝和切換多個 Python 版本。pyenv-virtualenv 是 pyenv 的擴充套件，讓您能管理多個虛擬環境。這些工具在處理具有不同相依性和 Python 版本的多個專案時特別有用。

II. 安裝

Mac

要在 macOS 上安裝 pyenv 和 pyenv-virtualenv，您可以使用 Homebrew：

brew update
brew install pyenv
brew install pyenv-virtualenv

安裝完成後，在您的 shell 設定檔（.bashrc、.zshrc 等）中加入以下幾行：

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

Linux

要在 Linux 上安裝 pyenv 和 pyenv-virtualenv，請先複製儲存庫並將其加入 PATH：

git clone https://github.com/pyenv/pyenv.git ~/.pyenv
git clone https://github.com/pyenv/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv

接著，在您的 shell 設定檔（.bashrc、.zshrc 等）中加入以下幾行：

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

III. 使用方法

1. 安裝 Python 版本

要安裝特定的 Python 版本，請使用 install 指令：

pyenv install 3.9.5

2. 列出可用的 Python 版本

要查看所有已安裝的 Python 版本，請使用 versions 指令：

pyenv versions

3. 設定全域 Python 版本

要設定全域 Python 版本，請使用 global 指令：

pyenv global 3.9.5

4. 設定本機 Python 版本

要為特定專案設定本機 Python 版本，請在專案目錄內使用 local 指令：

pyenv local 3.8.10

5. 確認目前的 Python 版本

要確認目前的 Python 版本，請使用 version 指令：

pyenv version

6. 建立虛擬環境

要使用 pyenv-virtualenv 建立新的虛擬環境，請使用 virtualenv 指令：

pyenv virtualenv 3.9.5 my-project-env

7. 啟用虛擬環境

要啟用虛擬環境，請使用 activate 指令：

pyenv activate my-project-env

8. 停用虛擬環境

要停用目前的虛擬環境，請使用 deactivate 指令：

pyenv deactivate

9. 列出可用的虛擬環境

要列出所有已建立的虛擬環境，請使用 virtualenvs 指令：

pyenv virtualenvs

10. 移除虛擬環境

要移除虛擬環境，請使用 uninstall 指令：

pyenv uninstall my-project-env

Bonus: Rehash

每當您安裝含有可執行腳本的新 Python 套件時，都必須執行 rehash 指令來更新 shim，確保新腳本可以正常使用：

pyenv rehash

IV. Conclusion

pyenv 和 pyenv-virtualenv 是在開發工作流程中管理多個 Python 版本和虛擬環境的寶貴工具。善用本指南所介紹的功能，您將能夠在具有不同相依性和 Python 版本的多個專案之間游刃有餘地工作。善用這些工具，維持簡潔有序的開發環境，提升您的生產力，同時降低相依性衝突的風險。