使用 pyenv 管理 Python 版本

早些年使用 Python 的時候大多使用 Conda 來管理。現在則是常用 pyenv 。

我們就在這篇文章中來記錄安裝 pyenv 的安裝與使用方式。

前置條件

在安裝 pyenv 之前，你需要有 Git 安裝在你的系統上。

資訊

在 pyenv 套件中有提供 安裝問題指南 。

如果你在安裝過程中遇到問題，可以參考這個頁面。

安裝 pyenv

1. 執行安裝指令：

   你可以通過以下指令快速安裝 pyenv：

   curl https://pyenv.run | bash

   這條指令實際上是從 GitHub 上的 pyenv-installer 存儲庫獲取安裝腳本並執行。

2. 設定你的 Shell 環境：

   安裝完畢後，根據 設定指南 配置你的 shell 環境，以確保 pyenv 能夠正確工作。

   如果你是使用 bash，則需要將以下代碼添加到你的 .bashrc 文件中：

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

   如果你使用的是 zsh，則需要將上述代碼添加到你的 .zshrc 文件中。

3. 重啟你的 Shell：

   當你完成上述步驟後，請重新載入新的配置。

   exec $SHELL

使用 pyenv

安裝和設定完成後，你可以開始使用 pyenv 管理多個 Python 版本：

• 安裝新的 Python 版本：

  pyenv install 3.10.14

• 切換全局 Python 版本：

  pyenv global 3.10.14

• 在特定目錄使用特定版本：

  pyenv local 3.8.5

虛擬環境

在 Python 開發中，虛擬環境是一個非常重要的概念。

它可以幫助我們在不同的專案中使用不同的 Python 版本和依賴庫。

至少當你不小心弄壞了 Python 環境時，你可以直接刪除虛擬環境，重新來過。

提示

我們一律建議在開發 Python 專案時使用虛擬環境。

安裝

pyenv 還提供了一個 pyenv-virtualenv 插件，可以讓你更方便地管理 Python 虛擬環境。

在早期這個功能需要單獨安裝，現在已經整合到 pyenv 中，我們可以直接用：

pyenv virtualenv 3.10.14 your-env-name

其中，3.10.14 是你想要使用的 Python 版本，你在上一個步驟已經完成安裝，your-env-name 是虛擬環境的名稱。

使用

啟動虛擬環境，請運行：

pyenv activate your-env-name

移除

最後，當你不需要虛擬環境，可以運行以下命令刪除：

pyenv virtualenv-delete your-env-name

更新 pyenv

如果需要更新 pyenv 到最新版本，只需運行：

pyenv update

移除 pyenv

如果你決定不再使用 pyenv，可以按照以下步驟移除：

1. 移除 pyenv 安裝目錄：

   rm -fr ~/.pyenv

2. 清理你的 .bashrc：

   移除或註釋掉相關的 pyenv 配置行，然後重啟你的 shell：

   exec $SHELL