pyenv虚拟环境管理

一. pyenv 简单介绍

在日常运维中, 经常遇到这样的情况: 系统自带的 Python 是，而业务部署需要 Python 环境, 此时需要在系统中安装多个 Python 版本，但又不能影响系统自带的 Python 版本,即需要实现 Python 的多版本环境共存, pyenv 就是这样一个 Python 版本管理器, 可以同时管理多个 python 版本共存! 简单的说，pyenv 可以根据需求使用户在系统里安装和管理多个 Python 版本：

配置当前用户的 python 的版本;
配置当前 shell 的 python 版本;
配置某个项目（目录及子目录）的 python 版本;
配置多个虚拟环境.

由于 python 的各种优点，当前学习及使用 python 的人越来越多, 学习 python有一个不容忽视的问题就是 python 的版本问题! 到现在为止，python 的版本有很多，但是问题在于 python2 与 python3 的区别。python3 的对一些模块进行了改变，导致了 python2 写的代码有的不被 python3 兼容，从而导致程序运行报错。因此，在学习和工作中使用 python 的时候，最好是安装一个 pyenv 管理器, 多安装几个 python 版本进行管理, 然后再针对不同项目安装各自项目的 python 虚拟环境, 相互隔离, 这样便于使用和管理。

二. pyenv 工作原理

pyenv 是利用系统环境变量 PATH 的优先级，劫持 python 的命令到 pyenv上，根据用户所在的环境或目录，使用不同版本的 python

how it works：
At a high level, pyenv intercepts Python commands using shim executables injected into your PATH, determines which Python version
has been specified by your application, and passes your commands along to the correct Python installation.

它是如何工作的：
在较高级别上，pyenv 使用注入到 PATH 中的 shim 可执行文件拦截 Python 命令，确定应用程序指定了哪个 Python 版本，并将命令传递到正确的 Python 安装。

对于系统环境变量 PATH ，里面包含了一串由冒号分隔的路径，例如 /usr/local/bin:/usr/bin:/bin。每当在系统中执行一个命令时，例如 python 或 pip，操作系统就会在 PATH 的所有路径中从左至右依次寻找对应的命令。因为是依次寻找，因此排在左边的路径具有更高的优先级。在 PATH 最前面插入一个 $(p y e n v r o o t) / s h i m s 目录，$ (pyenv root)/shims 目录里包含名称为 python 以及 pip 等可执行脚本文件；当用户执行 python 或 pip 命令时，根据查找优先级，系统会优先执行 shims 目录中的同名脚本。pyenv 正是通过这些脚本，来灵活地切换至我们所需的 Python 版本。

三. pyenv 安装和使用说明

1) pyenv 安装

(1) 安装依赖环境

yum -y install gcc zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel git

(2) 安装 pyenv 包

以下步骤如果出现Permission denied，说明需要root权限，请切换到root权限执行

方式一：推荐采用The automatic installer的方式安装，可以一键安装pyenv的所有插件。

curl -L /pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash

方式二：脚本安装

获取脚本：留言免费提供

执行脚本进行安装(执行前授予755权限)

# chmod 755 pyenv-installer
# /bin/bash pyenv-installer

安装完成后可以看到如下提示

WARNING: seems you still have not added 'pyenv' to the load path.

# Load pyenv automatically by adding
# the following to ~/.bashrc:

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

在 ~/.bashrc 文件底部添加下面三行内容，　让系统可以找到 pyenv 安装的 Python

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

使上面配置生效

[fatpuffer@localhost ~]# source ~/.bashrc

查看 pyenv 安装情况

[fatpuffer@localhost ~]# pyenv --version            // 或者"pyenv -v"
pyenv 1.2.14

更新 pyenv

[fatpuffer@localhost ~]# pyenv update

(3) 卸载 pyenv

先删除 pyenv 的安装目录, 这里即是 /home/fatpuffer/.pyenv

[fatpuffer@localhost ~]# rm -fr /home/fatpuffer/.pyenv

接着删除~/.bashrc里面配置的系统环境变量

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

最后使其生效

[fatpuffer@localhost ~]# source ~/.bashrc

2) pyenv 使用

当前系统默认的 Python 版本

[fatpuffer@localhost ~]$ python -V
Python 2.7.5

查看当前 pyenv 可检测到的所有版本,处于激活状态的版本前以 * 标示

[fatpuffer@localhost ~]$ pyenv versions
* system (set by /home/fatpuffer/.pyenv/version)

pyenv默认使用github镜像源，所以我们安装起来很慢，可以使用如下命令进行安装（只需要更换版本号即可）

v=3.7.2;wget /mirrors/python/$v/Python-$ -P ~/.pyenv/cache/;pyenv install $v

使用 pyenv install 安装 python，可以使用 -v 参数，查看安装过程。如下, 分别安装两个版本的 python

[root@localhost ~]# pyenv install -v 3.6.5
[root@localhost ~]# pyenv install -v 3.7.2

查看当前 pyenv 可检测到的 python 版本 (即 pyenv 当前安装了哪些 python 版本)


[fatpuffer@localhost ~]# pyenv versions
* system (set by /home/fatpuffer/.pyenv/version)
  3.6.5
  3.7.2

查看当前 pyenv 使用的python 版本 (注意是version, 而不是上面的versions)

[fatpuffer@localhost ~]$ pyenv version
system (set by /home/fatpuffer/.pyenv/version)

配置及管理 python 版本
pyenv 管理 python 版本的三个基础命令(即使用下面三个命令的途径进行python 版本的切换和激活状态):

pyenv global // 配置当前用户的系统使用的 python 版本. 可以使用这个命令进行python版本的切换!
pyenv shelll // 配置当前 shell 的 python 版本，退出 shell 则失效
pyenv local // 配置所在项目（目录）的 python 版本

特别注意:

在使用上面 pyenv 三个基础命令进行 python 版本切换后，如果想要切回到系统默认的 python 版本, 也就是这里默认的 python2.7.5, 则需要下面命令进行切回操作!!!

[fatpuffer@localhost p_b]# pyenv local system
[fatpuffer@localhost p_b]# python -V      
Python 2.7.5

下面分别介绍下 pyenv 这三个基础命令切换 python 版本的操作

a) 使用 pyenv global 配置当前用户的系统使用的 python 版本

[root@localhost ~]# pyenv versions
* system (set by /home/fatpuffer/.pyenv/version)
  3.6.5
  3.7.2

[root@localhost ~]# python -V
Python 2.7.5

使用下面命令进行 python 版本的切换

[root@localhost ~]# pyenv global 3.6.5

[fatpuffer@localhost ~]# pyenv versions
  system
  3.7.2
* 3.6.5 (set by /home/fatpuffer/.pyenv/version)

[fatpuffer@localhost ~]# python -V
Python 2.7.5  # 竟然没有切换到3.6.5版本

需要执行下面命令进行数据库更新后, pyenv 切换的 python 版本才会生效!

[fatpuffer@localhost ~]# pyenv rehash

[fatpuffer@localhost ~]# python -V      
Python 3.6.5

[fatpuffer@localhost ~]# which python
/home/fatpuffer/.pyenv/shims/python

特别注意：如果使用"pyenv global xxx" 以及 “pyenv rehash” 后仍然无法成功切换版本 ！这种情况一般是因为用 pyenv 指定了 local 版本！！

解决办法：取消设置 local 版本，即执行"pyenv local --unset"即可！

b) 使用 pyenv shelll 配置当前 shell 窗口的 python 版本，退出 shell 则失效

[fatpuffer@localhost ~]# python -V
Python 3.6.5

[fatpuffer@localhost ~]# pyenv versions
  system
  3.7.2
* 3.6.5 (set by /home/fatpuffer/.pyenv/version)

[fatpuffer@localhost ~]# pyenv shell 3.7.2

[fatpuffer@localhost ~]# python -V     
Python 3.7.2

如上设置后, 只在当前 shell 终端窗口有效, 退出重新登录或再打开另外一个窗口就不生效了 (即 python 版本还是之前的)即使执行"pyenv rehash" 进行更新操作, 在别的 shell 窗口也是不生效的!

当前 shell 下，取消配置的使用 pyenv shell --unset；若退出此 shell，配置也会失效。

[fatpuffer@localhost ~]# pyenv shell --unset
[fatpuffer@localhost ~]# python -V       
Python 3.6.5

c) 使用 pyenv local 配置所在项目（当前目录）的 python 版本

新建一个文件夹 ~/project，在此文件夹下使用 python local

[fatpuffer@localhost ~]# python -V 
Python 3.7.2
[fatpuffer@localhost ~]# mkdir project
[fatpuffer@localhost ~]# cd project/
[fatpuffer@localhost project]# pyenv local 3.6.5
[fatpuffer@localhost project]# pyenv versions
  system
* 3.6.5  (set by /home/fatpuffer/project/.python-version)
  3.7.2

在当前项目目录下查看 python 版本

[fatpuffer@localhost project]# python -V
Python 3.6.5

新建目录 ~/project/p1,切换到 ~/project/p1,并查看版本

[fatpuffer@localhost project]# mkdir p1 && cd p1
[fatpuffer@localhost p1]# python -V
Python 3.6.5

如上可知, 第三种命令操作后, 切换的 python 版本只能在当前所在项目目录下生效!在其他目录下就不会生效了!!

如果要想卸载掉 pyenv 安装的 python 版本, 就使用"pyenv uninstall " 命令

[fatpuffer@localhost ~]# pyenv versions
  system
  3.6.5
* 3.7.2 (set by /home/fatpuffer/.pyenv/version)

[fatpuffer@localhost ~]# pyenv uninstall 3.6.5
pyenv: remove /home/fatpuffer/.pyenv/versions/3.6.5? y

[root@localhost ~]# pyenv versions   
  system
* 3.7.2 (set by /home/fatpuffer/.pyenv/version)

四. python 虚拟环境部署

为了对不同的项目进行隔离，使每个项目使用独立的 python 解释器及依赖，需要配置 python 虚拟环境。每个项目都有一个单独的 python 虚拟环境, 这样项目之前的 python 环境相互隔离, 便于使用和管理!

[root@localhost ~]# pyenv versions    
  system
  3.7.2
* 3.6.5 (set by /home/fatpuffer/.pyenv/version)

上面使用 pyenv install 安装的 python 版本，比如 3.6.5

python3.6.1 解释器安装的路径为

/home/fatpuffer/.pyenv/versions/3.6.5

插件的安装的路径为

/home/fatpuffer/.pyenv/versions/3.6.1/lib/python3.6/site-packages

使用 pyenv-virtualenv 创建 python 虚拟环境，实质上是在/home/fatpuffer/.pyenv/versions/3.6.5/ 下创建一个文件夹 evns，存放该虚拟环境 python的解释器；并且在 ~/.pyenv/ 下创建一个软连接，该虚拟环境可以通过 pyenv 进行管理；

创建

比如创建某个项目的 python 虚拟环境, 虚拟环境的命令为 puffer_env(名称随便起), 该虚拟环境的 python 版本是2.7.5

[fatpuffer@localhost ~]# pyenv virtualenv 2.7.5 puffer_env

查看, 发现在 /home/fatpuffer/.pyenv/versions 目录下会有一个 kevin_py 虚拟环境的软连接

[fatpuffer@localhost ~]# ll ~/.pyenv/versions/
total 8
drwxr-xr-x 7 root root 4096 Oct 26 11:53 3.7.2
drwxr-xr-x 6 root root 4096 Oct 26 15:57 3.6.5
lrwxrwxrwx 1 root root   41 Oct 26 16:33 puffer_env -> /home/fatpuffer/.pyenv/versions/2.7.5/envs/puffer_env

查看 python 虚拟环境

[fatpuffer@localhost ~]# pyenv virtualenvs
  2.7.5/envs/puffer_env (created from /home/fatpuffer/.pyenv/versions/2.7.5)
  puffer_env (created from /home/fatpuffer/.pyenv/versions/2.7.5)

切换

有四种方法用于切换到 python 虚拟环境

方法一 (推荐这一个切换方法)

[fatpuffer@localhost ~]# pyenv activate puffer_env 
pyenv-virtualenv: prompt changing will be removed from future release. configure `export PYENV_VIRTUALENV_DISABLE_PROMPT=1' to simulate the behavior.
(puffer_env ) [fatpuffer@localhost ~]#

方法二 (这种切换方法也推荐)

[fatpuffer@localhost ~]# source activate puffer_env 
pyenv-virtualenv: activate puffer_env 
pyenv-virtualenv: prompt changing will be removed from future release. configure `export PYENV_VIRTUALENV_DISABLE_PROMPT=1' to simulate the behavior.
(puffer_env) [fatpuffer@localhost ~]# python -V
Python 2.7.5
(puffer_env) [fatpuffer@localhost ~]#

方法三

[fatpuffer@localhost ~]# source /home/fatpuffer/.pyenv/versions/2.7.5/envs/puffer_env/bin/activate puffer_env 
(puffer_env)[fatpuffer@localhost ~]#

方法四

[fatpuffer@localhost ~]# pyenv shell puffer_env
(puffer_env)[fatpuffer@localhost ~]#

退出

两种退出虚拟环境方法

方法一：

(puffer_env)[fatpuffer@localhost ~]#  source deactivate
[fatpuffer@localhost ~]#

‘方法二：

(puffer_env)[fatpuffer@localhost ~]#  pyenv deactivate
[fatpuffer@localhost ~]#

删除

删除虚拟环境

[fatpuffer@localhost ~]# pyenv virtualenv-delete puffer_env

官方安装教程

安装pyenv
安装pipenv

秒客网