聊聊如何随意切换Python版本

前言

不知道大家在日常开发工作中是否遇到过这样一个情况：

• 项目A用的是Python 2.7版本开发的(可能由于历史遗留问题没有升级更新版本)
• 项目B是用Python 3.10.4版本开发的，假设使用了requests==2.25.1版本
• 项目C是用Python 3.10.4版本开发的，假设使用了requests==2.27.1版本

首先第一个问题：Python版本的问题，Python 2.x 和Python 3.x 版本区别还是比较大的，版本多了不易管理。

其次第二个问题：也许requests的版本在项目B和项目C中并不会造成什么影响。但是在某些其他项目中使用了同一个包的不同版本可能会造成巨大的影响。那么此时就需要进行版本的区分，那么同一个Python版本要使用两种版本的包，显然这种场景下包管理是一个问题，在日常项目开发过程中保证不同的包环境互不干扰是很有必要，也是一个基本需求。那么最好的方式就是两个虚拟环境。

那么有没有一个最终的能解决管理不同版本的解释器的同时也能够提供一种功能来控制不同的包版本呢?当然是有的，它就是pyenv。

一、什么是pyenv?

pyenv是一个forked自ruby社区的Python环境管理工具，能够轻松的切换全局的Python解释器版本，并且他可以结合virtualenv方便的管理包。安装pyenv以后，他会在你的$PATH中增加环境变量，如下：

❯ echo $PATH
/Users/allenjol/.pyenv/plugins/pyenv-virtualenv/shims:/Users/allenjol/.pyenv/shims:/usr/local/bin:/usr/local/sbin

所以，pyenv其实是控制了你的PATH环境变量来做到Python的版本切换的。它通过对PATH路径开头插入一个shims的路径来对Python实现版本的控制。

二、pyenv、virtualenv、pipenv的关系和区别

前面说了pyenv是控制Python版本的，virtualenv是比较成熟的Python的虚拟环境管理工具，而pipenv是requrests包的作者Kenneth Reitz写的一个用来作为Python的包管理的工具，它同样可以实现生成虚拟环境。本文暂不讨论这个工具，后面一篇文章会介绍它。

pyenv侧重点在Python解释器版本的管理上，你可以随意的切换你的Python版本，并且不需要指定具体的虚拟环境目录。

三、虚拟环境pyenv

CentOS7下安装pyenv

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

MacOS下安装pyenv

brew update
brew install pyenv

如果你MacOS下因为网络原因无法很好的使用brew有两种解决办法：

• 更换源
• 参考https://sre.ayunw.cn/posts/terminal_configure_proxy_with_clash/ 这篇文章的方式进行代理设置

设置环境变量

# 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

source ~/.bashrc

# zsh下设置环境变量(我是iterm2+zsh)
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

source ~/.zshrc

查看pyenv版本

pyenv --version

四、命令行使用方法

# 查看当前版本
pyenv version
# 查看所有版本
pyenv versions
# 查看有哪些版本可供安装
pyenv install --list
# 安装python 3.10.4版本
pyenv install 3.10.4
# 安装一个版本后rehash一下,让pyenv知道管理的Python版本信息
pyenv rehash

# 卸载
pyenv uninstall 3.10.4
# 查看所有版本
❯ pyenv versions
system
* 3.10.4 (set by /Users/allenjol/.pyenv/version)

# 切换全局的Python版本,表示切换为系统的Python版本
pyenv global system
# 表示切换为pyenv的3.10.4版本
pyenv global 3.10.4

五、包管理插件pyenv-virtualenv

安装pyenv-virtualenv

Linux下安装

git clone https://github.com/yyuu/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv
 
# 配置环境变量
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bash_profile
source ~/.bash_profile

MacOS下安装

git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

# MacOS的zsh
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
exec "$SHELL"

# 方法二
brew install pyenv-virtualenv
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
exec "$SHELL"

使用pyenv-virtualenv

# 创建venv环境
pyenv virtualenv venv3.10.4
# 激活venv
pyenv activate venv3.10.4
pyenv version

# 退出venv环境
pyenv deactivate venv3.10.4

# 删除虚拟环境
pyenv uninstall venv3.10.4

当你切换了Python虚拟环境的时候，你的pip和你虚拟环境中的包都切换到你的目标环境中去了。和原先的环境没有任何关系。因此这样它得到了很好的python解释器环境和包的版本隔离。