一、pyenv概述

pyenv是一個(gè)Python版本管理工具，允許用戶在同一臺(tái)機(jī)器上安裝并切換多個(gè)Python版本。它通過修改環(huán)境變量實(shí)現(xiàn)版本隔離，適用于開發(fā)、測試或兼容性需求。

官方地址：https://github.com/pyenv/pyenv

Windows版本地址：https://github.com/pyenv-win/pyenv-win

核心功能

• 多版本共存：支持安裝Python 2.x、3.x等多個(gè)版本，包括CPython、PyPy、Anaconda等發(fā)行版。
• 版本切換：全局或按目錄指定Python版本，避免系統(tǒng)默認(rèn)版本沖突。
• 虛擬環(huán)境集成：結(jié)合pyenv-virtualenv插件可創(chuàng)建獨(dú)立的虛擬環(huán)境。

工作原理

pyenv通過將選定版本的Python路徑插入PATH環(huán)境變量最前端，覆蓋系統(tǒng)默認(rèn)路徑。版本安裝位置通常位于~/.pyenv/versions/目錄下。

典型使用場景

• 開發(fā)需兼容不同Python版本的項(xiàng)目。
• 快速測試代碼在新版本Python中的行為。
• 避免因系統(tǒng)Python升級(jí)導(dǎo)致的依賴問題。

常用命令示例

# 安裝指定Python版本  
pyenv install 3.9.12  

# 列出所有已安裝版本  
pyenv versions  

# 設(shè)置全局默認(rèn)版本  
pyenv global 3.9.12  

# 為當(dāng)前目錄設(shè)置局部版本  
pyenv local 3.8.10  

與類似工具對(duì)比

• virtualenv：僅管理虛擬環(huán)境，不解決多版本安裝問題。
• conda：側(cè)重科學(xué)計(jì)算生態(tài)，版本管理是其子功能。
• pyenv：專注輕量級(jí)版本切換，適合純Python開發(fā)。

pyenv的模塊化設(shè)計(jì)使其成為處理多版本Python需求的常用選擇，尤其適合需要頻繁切換版本的開發(fā)者。

二、pyenv部署

Windows環(huán)境部署

官方手冊參考：https://github.com/pyenv-win/pyenv-win/blob/master/docs/installation.md#git-commands

1、創(chuàng)建pyenv文件夾

打開D盤創(chuàng)建pyenv文件夾

2、下載源碼

cmd進(jìn)入D:\pyenv文件夾，執(zhí)行如下命令

git clone https://github.com/pyenv-win/pyenv-win.git

如果下載失敗，則手動(dòng)從上述地址下載zip包，然后解壓到 D:\pyenv文件夾中

3、配置環(huán)境變量

參考：https://github.com/pyenv-win/pyenv-win/blob/master/docs/installation.md#add-system-settings

打開系統(tǒng)環(huán)境變量，添加一下三個(gè)變量PYENV，PYENV_HOME ， PYENV_ROOT ，內(nèi)容都為D:\pyenv\pyenv-win

如：

在Path中添加如下內(nèi)容

%PYENV_ROOT%\pyenv-win\bin

和

%PYENV_ROOT%\pyenv-win\shims

保存并退出

4、驗(yàn)證是否安裝成功

打開cmd,執(zhí)行

pyenv --version

如上已安裝成功

輸入以下命令，可查看當(dāng)前激活的Python使用版本

pyenv version

5、安裝其它Python版本

安裝Python版本：

pyenv install 3.12

 要切換到 “3.12” Python 環(huán)境，設(shè)置全局Python版本：

pyenv global 3.12

查看當(dāng)前版本

pyenv version

查看可用的Python版本：

pyenv versions

通過以上步驟，你就可以在Windows上使用Pyenv來管理多個(gè)Python版本了。

6、Python與Pyenv版本切換

如果電腦上之前已經(jīng)裝過了Python，不是通過pyenv控制的，pip默認(rèn)使用環(huán)境變量中考前的版本，自行調(diào)整優(yōu)先級(jí)即可

如果不想調(diào)整優(yōu)先級(jí)，默認(rèn)是Python安裝的，又想用pyenv,則在pip前面加上pyenv exec 即可（不建議）

如：pyenv exec pip install poetry

Ubuntu環(huán)境部署

1、安裝依賴項(xiàng)

sudo apt update
sudo apt install -y build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev

2、源碼下載，上傳并解壓

https://github.com/pyenv/pyenv

unzip pyenv-master.zip
mv pyenv-master pyenv

3、配置環(huán)境變量

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init --path)"' >> ~/.bashrc
exec $SHELL

echo 'eval "$(pyenv init --path)"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
exec $SHELL

4、驗(yàn)證是否安裝成功

打開cmd,執(zhí)行

pyenv --version

如上已安裝成功

5、安裝其它Python版本

查看可以安裝的版本

pyenv install --list

安裝Python版本：

pyenv install 3.11

設(shè)置全局Python版本：

pyenv global 3.11

查看當(dāng)前版本

pyenv version

查看可用的Python版本：

pyenv versions

輸入

python

通過以上步驟，你就可以在Linux上使用Pyenv來管理多個(gè)Python版本了。

三、常用命令

1. 命令概覽

pyenv 是一個(gè)用于管理多個(gè) Python 版本的工具，提供了以下核心命令：

2. 常用命令示例

安裝 Python 版本

# 查看所有可用的 Python 版本
pyenv install --list

# 安裝特定版本的 Python
pyenv install 3.9.7

# 安裝多個(gè) Python 版本
pyenv install 3.8.12 3.9.7 3.10.0

設(shè)置 Python 版本

# 設(shè)置全局 Python 版本
pyenv global 3.9.7

# 設(shè)置項(xiàng)目局部 Python 版本（會(huì)在當(dāng)前目錄創(chuàng)建 .python-version 文件）
pyenv local 3.8.12

# 設(shè)置當(dāng)前 shell 會(huì)話的 Python 版本
pyenv shell 3.10.0

查看 Python 版本

# 查看當(dāng)前使用的 Python 版本
pyenv version

# 查看所有可用的 Python 版本
pyenv versions

# 查看特定命令對(duì)應(yīng)的路徑
pyenv which python
pyenv which pip

卸載 Python 版本

# 卸載指定的 Python 版本
pyenv uninstall 3.8.12

其他實(shí)用命令

# 更新 pyenv 已知的 Python 版本列表
pyenv update

# 在切換 Python 版本后，重新生成 shims
pyenv rehash

# 查找包含特定可執(zhí)行文件的 Python 版本
pyenv whence pip

3. 使用技巧

使用 exec 命令

pyenv exec 用于執(zhí)行特定 Python 版本環(huán)境下的命令，確保使用正確的 Python 環(huán)境：

# 使用 pyenv 管理的 Python 版本執(zhí)行腳本
pyenv exec python my_script.py

# 使用 pyenv 管理的 pip 安裝包
pyenv exec pip install requests

結(jié)合 .python-version 文件

在項(xiàng)目根目錄創(chuàng)建 .python-version 文件，可以自動(dòng)切換到指定的 Python 版本：

# 手動(dòng)創(chuàng)建文件并指定版本
echo "3.9.7" > .python-version

# 或者使用 pyenv local 命令自動(dòng)創(chuàng)建
pyenv local 3.9.7

4. 注意事項(xiàng)

• shims 機(jī)制：pyenv 通過在 PATH 前添加 shims 目錄來實(shí)現(xiàn)版本切換，因此在安裝新的 Python 版本或修改環(huán)境后，需要運(yùn)行 pyenv rehash。
• 環(huán)境變量：如果遇到版本切換不生效的問題，檢查 PATH 環(huán)境變量是否正確配置，確保 ~/.pyenv/bin 和 ~/.pyenv/shims 在 PATH 中。
• 更新 pyenv：定期運(yùn)行 git -C ~/.pyenv pull 更新 pyenv 本身。

掌握這些命令后，你可以輕松在不同 Python 版本之間切換，為不同項(xiàng)目配置獨(dú)立的 Python 環(huán)境。

到此這篇關(guān)于Python多版本管理工具pyenv安裝及使用詳解的文章就介紹到這了,更多相關(guān)Python多版本管理工具pyenv 內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！