pyenv 主要用来对 Python 解释器进行管理，可以管理系统上的多个版本的 Python 解释器。它的主要原理就是将新的解释器路径放在 PATH 环境变量的前面，这样新的 python 程序就”覆盖”了老的 python 程序，达到了切换解释器的目的。

pyenv-virtualenv虚拟环境管理也是一样，shims管理各个虚拟环境命令的路径，然后再将shims路径插入到系统环境变量最前面，达到切换虚拟环境的目的。

1、安装pyenv：

pyenv不是自带的，需要额外安装。

方式一：

使用git来安装：

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

配置环境变量：

sed -Ei -e '/^([^#]|$)/ {a \
export PYENV_ROOT="$HOME/.pyenv"
a \
export PATH="$PYENV_ROOT/bin:$PATH"
a \
' -e ':a' -e '$!{n;ba};}' ~/.bash_profile
echo 'eval "$(pyenv init --path)"' >> ~/.bash_profile

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

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

请注意，以上的三条 echo 命令的最后一条长长的命令，请你保证它引号中的内容处于 ~/.bashrc 或者 ~/.zshrc 的最底部。

因为在 pyenv 初始化期间会操作路径 环境变量，导致不可预测的行为。

重启当前shell，加载新的环境变量

exec $SHELL -l

测试是否安装成功：

[root@ops-130 ~]# pyenv versions
* system (set by /root/.pyenv/version)

安装过程如下：

此时，表示pyenv安装成功。

安装方式二：

直接使用别人写好的脚本一键安装：

curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash

安装脚本有可能会提示你手动把几行命令添加到shell的配置文件中。

将来要进行更新的话：

pyenv update

要卸载pyenv的话更加简单，直接删除目录即可：

rm -fr ~/.pyenv

别忘了把.bashrc中的这几行也一并删掉：

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

2、python环境管理

2.1、解释器版本安装与切换

使用pyenv安装指定python版本

pyenv install 2.7.8

安装过程中，可能会显示缺少一些包，补上就好了。

先安装依赖包：

yum install patch -y
pyenv install 2.7.8

安装成功如下：

安装新版本后，需要rehash一下

pyenv rehash

查看当前版本：

# 查看当前版本
pyenv version

# 查看 pyenv 已经托管了哪些 python 版本
pyenv versions

当前版本为系统使用版本：

切换当前目录的python版本为2.7.8

pyenv local 2.7.8

再次查看当前python版本，发现已经切换了。

查看所有可安装的软件版本

[root@ops-130 ~]# pyenv install -l
Available versions:
  2.1.3
  ...
  2.7.15
  ...
  3.6.6
  3.7.0
  3.7-dev
  3.8-dev
  activepython-2.7.14
  activepython-3.5.4
  activepython-3.6.0
  anaconda-1.4.0
  ...  
  anaconda3-5.2.0
  ironpython-dev
  ironpython-2.7.4
  ironpython-2.7.5
  ironpython-2.7.6.3
  ironpython-2.7.7
  jython-dev
  jython-2.5.0
  jython-2.5-dev
  jython-2.5.1
  jython-2.5.2
  jython-2.5.3
  jython-2.5.4-rc1
  jython-2.7.0
  jython-2.7.1
  micropython-dev
  micropython-1.9.3
  micropython-1.9.4
  miniconda-latest
  miniconda-2.2.2
  ...
  miniconda3-4.3.30
  pypy-c-jit-latest
  pypy-c-nojit-latest
  pypy-dev
  pypy-stm-2.3
  pypy-stm-2.5.1
  pypy-1.5-src
  pypy-1.5
  ...
  pypy3.5-6.0.0
  pyston-0.5.1
  pyston-0.6.0
  pyston-0.6.1
  stackless-dev
  stackless-2.7-dev
  stackless-2.7.2
  ...
  stackless-3.5.4

2.2、virutalenv 使用 pyenv 安装的 python 版本

// 通过 -p 参数指定 pyenv 安装的 python 3.3.3 的 bin 目录
# virtualenv -p /root/.pyenv/versions/3.3.3/bin/python3.3 py3.3

2.3、三种解释器版本控制方法比较（global、shell、local）

pyenv控制版本的方式有三种，分别是：global、shell、local，下面分别来看看这三种方式：

首先是pyenv shell会话设置：（只影响当前会话）

会话一：

[root@ops-130 ~]# pyenv versions
* system (set by /root/.pyenv/version)
  2.7.8
  3.3.3
# pyenv修改python版本  
[root@ops-130 ~]# pyenv shell 3.3.3
[root@ops-130 ~]# pyenv versions
  system
  2.7.8
* 3.3.3 (set by PYENV_VERSION environment variable)
[root@ops-130 ~]# python -V
Python 3.3.3
[root@ops-130 ~]#

可以看到，使用pyenv shell切换会话里的python版本后，

会话1的pyenv和python显示版本均为3.3.3

会话二：

重新打开一个会话窗口，查看python版本

WARNING! The remote SSH server rejected X11 forwarding request.
Last login: Tue Jan  4 09:28:51 2022 from 192.168.90.197
[root@ops-130 ~]# cd /data/
[root@ops-130 data]# pyenv versions
* system (set by /root/.pyenv/version)
  2.7.8
  3.3.3
[root@ops-130 data]# python -V
Python 2.7.5
[root@ops-130 data]#

可以看到新打开的会话是Python 2.7.5，并没有受到影响，所以shell只会影响到当前的会话，一旦这个会话结束，则一切失效

pyenv local本地设置（只影响当前目录）

它会在当前目录创建一个.python-version文件，里面记录着版本内容

新建目录/data/test

[root@ops-130 test]# pyenv versions
* system (set by /root/.pyenv/version)
  2.7.8
  3.3.3
# pyenv local修改python版本  
[root@ops-130 test]# pyenv local 3.3.3
[root@ops-130 test]# pyenv versions
  system
  2.7.8
* 3.3.3 (set by /data/test/.python-version)
[root@ops-130 test]# python -V
Python 3.3.3
# 在当前目录生成.python-version版本文件
[root@ops-130 test]# ls -a
.  ..  .python-version  test2
[root@ops-130 test]# cat .python-version 
3.3.3

创建一个子目录test2

[root@ops-130 test]# mkdir test2
[root@ops-130 test]# cd test2
[root@ops-130 test2]# pyenv versions
  system
  2.7.8
* 3.3.3 (set by /data/test/.python-version)
[root@ops-130 test2]# python -V
Python 3.3.3

发现子目录也随之一起改变了

再回到父目录查看：

父目录不变。

所以 pyenv local命令只会对当前的文件夹和其子目录中的版本起作用 ，其他的目录不起作用

[root@ops-130 test]# cd ..
[root@ops-130 data]# pyenv versions
* system (set by /root/.pyenv/version)
  2.7.8
  3.3.3
[root@ops-130 data]# python -V
Python 2.7.5

pyenv global 全局设置

如果使用此命令，可以看到所有受到pyenv控制的窗口都受到了影响， 所以尽可能不要用root用户来安装pyenv，否则会影响到之前的系统

原理是：

该命令执行后会在 $(pyenv root) 目录(默认为 ~/.pyenv )中创建一个名为 version 的文件(如果该文件已存在，则修改该文件的内容)，里面记录着系统全局的Python版本号。

# 全局设置，会覆盖所有的目录和窗口
[root@ops-130 ~]# pyenv global 2.7.8
[root@ops-130 ~]# pyenv versions
  system
* 2.7.8 (set by /root/.pyenv/version)
  3.3.3
# 会在~/.pyenv中创建version文件
[root@ops-130 ~]# ls /root/.pyenv/ 
bin    CHANGELOG.md  completions  Dockerfile  LICENSE   man      pyenv.d    shims  terminal_output.png  version
cache  COMMANDS.md   CONDUCT.md   libexec     Makefile  plugins  README.md  src    test                 versions
[root@ops-130 ~]# cat /root/.pyenv/version
2.7.8

切换到其他目录查看：

# opt也被改成了2.7.8
[root@ops-130 test]# cd /opt/
[root@ops-130 opt]# pyenv versions
  system
* 2.7.8 (set by /root/.pyenv/version)
  3.3.3

切换到之前local设置的目录：local并没有被global覆盖

[root@ops-130 ~]# cd /data/test/
[root@ops-130 test]# pyenv versions
  system
  2.7.8
* 3.3.3 (set by /data/test/.python-version)

如果要取消pyenv的版本设置：

# 取消当前shell窗口的
pyenv shell --unset
# 取消当前目录的
pyenv local --unset
# 取消全局设置
pyenv global system

优先级比较： shell > local > global

更多命令使用，参考官网： https://github.com/pyenv/pyenv/blob/master/COMMANDS.md#pyenv-local

3、虚拟环境管理 （pyenv-virtualenv）

3.1、安装pyenv-virtualenv

pyenv要使用虚拟环境管理，必须安装一个插件pyenv-virtualenv

git clone https://github.com/pyenv/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bash_profile
source ~/.bash_profile

查看是否安装成功：

pyenv help virtualenv

如下图：

3.2、虚拟环境创建与切换

使用pyenv创建虚拟环境（不需要指定目录）

# 直接创建虚拟环境myproj3，它不需要指定目录，不会在当前目录生成myproj3目录文件
pyenv virtualenv 3.3.3 myproj3

如下图：会发现多出了两个python的环境

查看虚拟环境列表：

pyenv virtualenvs

如下图：

激活虚拟环境：

pyenv activate myproj3

如下图，环境已经激活，切换到了myproj3环境中，虚拟环境名已经出现在前缀上。

退出虚拟环境

pyenv deactivate

如下图：

删除虚拟环境：

# 直接卸载该环境
pyenv uninstall myproj3

如下图：

3.3、虚拟环境隔离原理：（shims原理）

观察PATH路径，可以发现，pyenv的虚拟环境隔离是通过插入shims路径到PATH头部，实现的。

cat $PATH

shims路径如下：里面都是一些经常使用的命令引用路径，pip、python等。

当切换虚拟环境时，pyenv就会将对应环境的命令拷贝，覆盖掉shims路径下的命令，并在PATH的头部插入shims路径，来实现python版本的切换。

(myproj3) [root@ops-130 ~]# ls /root/.pyenv/shims/
2to3      easy_install      idle     pip     pip3    pydoc3    python2           python2.7-gdb.py  python3.3         python3.3m-config  pyvenv      wheel
2to3-3.3  easy_install-2.7  idle3    pip2    pip3.3  pydoc3.3  python2.7         python2-config    python3.3-config  python3-config     pyvenv-3.3
activate  easy_install-3.3  idle3.3  pip2.7  pydoc   python    python2.7-config  python3           python3.3m        python-config      smtpd.py
(myproj3) [root@ops-130 ~]# which pip
/root/.pyenv/shims/pip

如下图：

3.4、关于虚拟环境pip没有切换的问题

注意：（PS：使用pyenv-virtualenv创建虚拟环境的时候，经常因为下载pip不成功，导致pip包环境没有切换过来。）

如下图：这里下载pip就没有成功。

此时，我们发现虽然成功创建了虚拟环境myproj，但是里面的pip并没有切换，如下：

# 虽然进入了虚拟环境，python环境切换过来了，但是pip环境还是旧的，没有切换过来
(myproj3) [root@ops-130 ~]# pyenv versions
  system
  2.7.8
  3.3.3
  3.3.3/envs/myproj3
* myproj3 (set by PYENV_VERSION environment variable)
(myproj3) [root@ops-130 ~]# python -V
Python 3.3.3
# pip环境还是旧的
(myproj3) [root@ops-130 ~]# pip -V
pip 8.1.2 from /usr/lib/python2.7/site-packages (python 2.7)
# 此时如果使用pip是无法安装到对应的虚拟环境的

进入虚拟环境：我们手动重新安装一下pip

curl https://bootstrap.pypa.io/pip/3.3/get-pip.py | python

如下图：

再次验证：发现此时pip已经切换过来了，可以使用pip安装软件包了。

(myproj3) [root@ops-130 ~]# which pip
/root/.pyenv/shims/pip
(myproj3) [root@ops-130 ~]# pip -V
pip 10.0.1 from /root/.pyenv/versions/myproj3/lib/python3.3/site-packages/pip (python 3.3)

如下图：

4、pyenv+anaconda

pyenv内部集成了anaconda的软件包，可以在pyenv+anaconda环境。

# 查看软件库，有很多anaconda的版本，也有miniconda的
pyenv install --list

安装anaconda3-2.5.0

# anaconda依赖bzip2，先安装这个库
yum install bzip2 -y
# pyenv安装anaconda
pyenv install anaconda3-2.5.0

pyenv使用anaconda环境

# 方法一：直接切换anaconda环境

# 方法一：直接切换anaconda
[root@ops-130 test]# pyenv versions
  system
  2.7.8
* 3.3.3 (set by /data/test/.python-version)
  3.3.3/envs/myproj3
  anaconda3-2.5.0
  myproj3
[root@ops-130 test]# pyenv local anaconda3-2.5.0
# 发现里面python版本也是anaconda自带的版本3.5.1
[root@ops-130 test]# python -V
Python 3.5.1 :: Anaconda 2.5.0 (64-bit)
[root@ops-130 test]# which python
/root/.pyenv/shims/python

如下图：

方法二：创建使用anaconda的虚拟环境

# 创建虚拟环境的过程中，它会下载一些包，包括pip之类的。
[root@ops-130 ~]# pyenv virtualenv anaconda3-2.5.0  myproj4
查看当前托管版本：
[root@ops-130 ~]# pyenv versions
* system (set by /root/.pyenv/version)
  2.7.8
  3.3.3
  3.3.3/envs/myproj3
  anaconda3-2.5.0
  anaconda3-2.5.0/envs/myproj4
  myproj3
  myproj4

激活环境：

[root@ops-130 ~]# pyenv activate myproj4

如下图：

接下来，就可以使用conda来安装管理库了，

(myproj4) [root@ops-130 ~]# conda install py4j

如下图：

退出虚拟环境：

pyenv deactivate

5、优缺点分析：

1、pyenv极大程度的利用了环境变量工具，通过在环境变量前面插入新路径来实现python解释器版本管理和虚拟环境管理。

2、pyenv相比其他工具，更加侧重在python 解释器版本管理上， 比包管理更大一个层级， 使用pyenv我可以方便的下载指定版本的python解释器， pypy， anaconda等， 可以随时自由的在shell环境中本地、全局切换python解释器

3、开发的时候不需要限定某个版本的虚拟环境， 只需要在部署的时候用pyenv local指定当前项目目录使用某个版本就好了，很方便。

4、pyenv切换解释器版本的时候， pip和ipython以及对应的包环境都是一起切换的。（PS：其他工具也是会一起切换的。）有些场景验证多个版本的代码更方便

（PS：使用pyenv-virtualenv创建虚拟环境的时候，经常因为下载pip不成功，导致pip包环境没有切换过来。不过可以自己进入虚拟环境，再手动安装pip解决这个问题。）

5、pyenv也可以创建好指定的虚拟环境， 但不需要指定具体目录， 自由度更高， 使用也简单

个人常用的做法是为每个项目创建不同的虚拟环境， 当进入该环境的时候就可以随便浪而不用担心影响到其它项目， 搭配Pycharm使用效果更佳.

注意：pyenv 不支持 Windows 系统。Windows 上有一个 pyenv 的替代品，是 pywin 。它用来在多个安装的 Python 版本之间进行切换

最后修改日期: 2023年12月24日