什麼是 pyenv，為什麼需要它？

pyenv 是一個簡單但功能強大的工具，可讓您管理系統上的多個 Python 版本。身為 Python 開發人員，您經常需要處理需要不同 Python 版本的不同專案。手動管理這些版本可能很麻煩且容易出錯。這就是 pyenv 的用武之地，它可以輕鬆地在 Python 版本之間切換，確保您的專案始終在正確的版本上運行。

為什麼要使用 pyenv？

• 版本管理：輕鬆安裝和切換不同的Python版本。

• 項目隔離：確保每個項目使用正確的Python版本，避免相容性問題。

• 靈活性：在多個 Python 版本上輕鬆測試您的程式碼。

如果您曾經遇到過版本衝突的問題，或者必須在同一台電腦上同時使用 Python 2.x 和 3.x，您將會欣賞 pyenv 如何簡化您的開發工作流程。

將 pyenv 與 Poetry 集成

pyenv 與 Poetry 配合得非常好，Poetry 是一個管理依賴項和 Python 環境的工具。如果您已經熟悉 Poetry（如果您不熟悉，請查看我關於 Poetry 入門的文章），您會發現將其與 pyenv 結合使用可以讓您更好地控制您的專案。

當您使用 Poetry 建立新專案時，它會自動使用 pyenv 為目錄設定的 Python 版本。這可確保在符合您的專案要求的環境中管理您的專案依賴項。

安裝 pyenv

讓我們從安裝 pyenv 開始。安裝過程會因您的作業系統而異。

在 macOS 上

使用自製程式：

brew update
brew install pyenv

為了避免它們意外連結到 Pyenv 提供的 Python，請將以下行加入互動式 shell 的配置中：

• Bash/Zsh：

alias brew='env PATH="${PATH//$(pyenv root)\/shims:/}" brew'

• 魚：

alias brew="env PATH=(string replace (pyenv root)/shims '' \"\$PATH\") brew"

在 Linux 上

• 使用捲曲：

curl https://pyenv.run | bash

安裝後，將以下內容新增至 shell 設定檔（例如 .bashrc、.zshrc）：

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

• 使用套件管理器 在 Arch Linux 上可以藉助 pacman 進行安裝

sudo pacman -S pyenv

透過在終端機中執行以下命令將命令新增至 ~/.bashrc：

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

對於魚：
如果您有 Fish 3.2.0 或更高版本，請以互動方式執行此操作：

set -Ux PYENV_ROOT $HOME/.pyenv
fish_add_path $PYENV_ROOT/bin

否則，執行下面的程式碼片段：

set -Ux PYENV_ROOT $HOME/.pyenv
set -U fish_user_paths $PYENV_ROOT/bin $fish_user_paths

現在，將其新增至 ~/.config/fish/config.fish:

pyenv init - | source

有關更多詳細信息，請查看他們的 GitHub。

使用 Pyenv

1) 檢查Python版本

查看目前使用的Python版本：

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)

2) 安裝Python版本

使用pyenv，您可以輕鬆安裝任何版本的Python：

❯ pyenv install 3.11.9

安裝python版本後，可以對專案進行全域或本機設定

3) 設定全域Python版本

不推薦，可能會導致您的系統出現問題
您可以設定一個全域Python版本，該版本將在您的系統中預設使用：

pyenv global 3.10.6 

4) 設定本地Python版本

您也可以為特定專案目錄設定本地Python版本。當您位於該目錄中時，此版本將覆寫全域版本：

❯ pyenv local 3.8.10

❯ pyenv versions
  system
* 3.11.9 (set by /home/shanu/test_folder/.python-version)

❯ python -V
Python 3.11.9 (my global version is 3.12.5)

要取消設置，只需運行：

❯ pyenv local --unset

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)
  3.11.9

❯ python -V
Python 3.12.5

5) 卸載Python版本

卸載不再需要的Python版本：

pyenv uninstall 3.11.9

結論

Pyenv 對 Python 開發人員來說是一個非常寶貴的工具，特別是與 Poetry 結合使用時。透過輕鬆管理Python版本，它可以讓您專注於編寫程式碼而不用擔心版本衝突。在你的下一個 Python 專案中嘗試一下吧！