pyenv install

简介

提到 Python 环境管理，更多人可能会首先想到 virtualenv。但与用于创建独立包环境的 virtualenv 不同，pyenv 的作用仅限于维护不同版本的 Python。它的使用不依赖于 Python，是一个简单、独立的纯 shell 脚本工具。pyenv 也以pyenv-virtualenv 插件的形式支持 virtualenv，强烈建议使用。安装后比较方便的是可以在你 cd 到项目目录时自动切换相应的虚拟环境，而不用老是 source.

需求

---

出于种种原因，很多人的电脑上会同时安装很多个版本的 Python，比如会有 2.7 + 3.4。一般在 windows 下我们都可以通过使用绝对路径的方式来绕过系统对 PATH 环境变量的查询；在 Linux 下除了这种方式外，还可以在脚本文件开头显示指定需要使用的解释器，就像这样：#!/usr/bin/env python2.7 或 #!usr/bin/env python3.4。一旦特定版本的解释器被打开后，就不用再担心 PATH 的问题了。

就是有点麻烦。所以为了能让用户随心所欲地使用不同版本的诸如 python、pip、django-admin.py 这样的命令，本篇的主题，pyenv 就被开发出来了。pyenv 在安装和配置完毕后可以实现：一键（命令）切换全局、本地或当前 shell 使用的 Python 版本。 

原理

---

pyenv 的美好之处在于，他并没有使用将不同的 $PATH 植入不同的 shell 这种高耦合的工作方式，而是简单地在 $PATH 的最前面插入了一个垫片路径（shims）：~/.pyenv/shims:/usr/local/bin:/usr/bin:/bin。所有对 Python 可执行文件的查找都会首先被这个 shims 路径截获，从而架空了后面的系统路径。 

安装

pyenv 的 github 页面 提供了完整的安装与使用指导，所以本文基本上就是对 Readme 的翻译和解释。 

软件依赖

---

Linux 下安装 pyenv 前需要做一些准备工作，详情参考 Requirements 页面。例如 UP 使用的 Ubuntu 系统就需要先执行如下命令：sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm 

自动安装

---

作者很亲切地提供了一个自动安装工具：

$ curl -L https://raw.githubusercontent.com/yyuu/pyenv-installer/master/bin/pyenv-installer | bash

如果想自己手动安装并进行配置的话，可参考下面的步骤。 

Github 检出

---

1. 将 pyenv 检出到你想安装的目录。建议路径为：$HOME/.pyenv

   $ cd$ git clone git://github.com/yyuu/pyenv.git .pyenv

   
   

2. 添加环境变量。PYENV_ROOT 指向 pyenv 检出的根目录，并向 $PATH 添加 $PYENV_ROOT/bin 以提供访问 pyenv 这条命令的路径

   $ echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile$ echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile

   这里的 shell 配置文件（~/.bash_profile）依不同 Linux 而需作修改——Zsh：~/.zshenv；Ubuntu：~/.bashrc 
   
   

3. 向 shell 添加 pyenv init 以启用 shims 和命令补完功能

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

   配置文件的位置同上一条一样需要修改 
   
   

4. 重启 shell（因为修改了 $PATH）

   $ exec $SHELL

使用

pyenv 总共也就 11 条不同的命令，详情可参见：Command Reference。下面就最重要的几（8）条进行说明： 

pyenv versions

---

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

 $ pyenv versions 2.5.6 2.6.8*2.7.6 (set by /home/yyuu/.pyenv/version) 3.3.3 jython-2.5.3 pypy-2.2.1

pyenv version

---

查看当前处于激活状态的版本，括号中内容表示这个版本是由哪条途径激活的（global、local、shell）

$ pyenv version2.7.6 (set by /home/yyuu/.pyenv/version)

pyenv install

---

使用 python-build（一个插件） 安装一个 Python 版本，到 $PYENV_ROOT/versions 路径下。

$ pyenv install -v 2.7.3

建议添加 -v 参数用于显示细节。python-build 会首先尝试从一个镜像站点下载包，此时可以去 /tmp/python-build.xxx 里面关心一下下载速度。如果太慢，可以直接在 shell 里 ctrl-c 终止此次下载，然后 python-build 会自动去 python.org/ftp 下载。不一定哪个更快。 

pyenv uninstall

---

卸载一个版本

$ pyenv uninstall 2.7.3

pyenv rehash

---

为所有已安装的可执行文件 （如：~/.pyenv/versions/*/bin/*） 创建 shims，因此，每当你增删了 Python 版本或带有可执行文件的包（如 pip）以后，都应该执行一次本命令

$ pyenv install 2.7.3$ pyenv rehash

pyenv global

---

设置全局的 Python 版本，通过将版本号写入 ~/.pyenv/version 文件的方式。

$ pyenv global 3.4.0

pyenv local

---

设置面向程序的本地版本，通过将版本号写入当前目录下的 .python-version 文件的方式。通过这种方式设置的 Python 版本优先级较 global 高。pyenv 会从当前目录开始向上逐级查找 .python-version 文件，直到根目录为止。若找不到，就用 global 版本。

$ pyenv local 2.7.3

pyenv shell

---

设置面向 shell 的 Python 版本，通过设置当前 shell 的 PYENV_VERSION 环境变量的方式。这个版本的优先级比 local 和 global 都要高。--unset 参数可以用于取消当前 shell 设定的版本。

$ pyenv shell pypy-2.2.1$ pyenv shell --unset$ pyenv shell pypy-2.2.1$ pyenv shell --unset

首先我们创建一个2.7.1的虚拟环境

view sourceprint?

1.pyenv virtualenv 2.7.1 env271

这条命令在本机上创建了一个名为env271的python虚拟环境，这个环境的真实目录位于：~/.pyenv/versions/

注意，命令中的 ‘2.7.1’ 必须是一个安装前面步骤已经安装好的python版本， 否则会出错。

然后我们可以继续通过 ‘pyenv versions’ 命令来查看当前的虚拟环境， 结果如下：

view sourceprint?

1.* system (set by /home/tony/.pyenv/version)

2.2.7.1

3.3.3.5<br>  env271

这里我们可以看到， 除了已经安装的python版本， 我们多出了一个env271的python虚拟环境

6. 切换和使用新的python虚拟环境

切换到新的虚拟环境的命令为

view sourceprint?

1.pyenv activate env271

接下来我们的python环境就已经切换到2.7.1的虚拟环境了， 运行 ‘python’ 命令认证

view sourceprint?

1.(env271)tony@ubuntu:~$ python

2.Python 2.7.1 (r271:86832, May  9 2014, 01:07:17)

3.[GCC 4.8.2] on linux3

4.Type "help", "copyright", "credits" or "license" for more information.

5.>>>

可以看到， python版本已经是2.7.1, 而且是在虚拟环境之中 （env271)

下面基本上你就可以在这个虚拟环境里面为所欲为了 :) 再也不用担心系统路径被搞乱的问题了。

如果要切换回系统环境， 运行这个命令即可

view sourceprint?

1.pyenv deactivate

那如果要删除这个虚拟环境呢？ 答案简单而且粗暴，只要直接删除它所在的目录就好：

view sourceprint?

1.rm -rf ~/.pyenv/versions/env271/