VirtualEnv 和Pip 构建Python的虚拟工作环境

（这是打算写的这个系列 http://www.v2ex.com/t/33489 的第一篇，我不会太监，毕竟这些内容本来在公司内部或多或少就会有整理，不过工作本身忙，进度快慢不能保证，各位谅解）

一般而言，所有python相关的包会装在系统目录里，譬如/usr/lib/ 或者/usr/local/lib/，这样的话，假设两个开发分支要求的库不一样，譬如对应在线版本的开发环境使用 Django1.3，但是一个新的开发分支基于Django1.4，两者就会互相影响。

Virtualenv 是一个虚拟环境程序，可以把开发环境隔离。基本思想是建立不同的环境目录，其中装有独立的各类包，甚至也可以是独立的不同版本python程序。

1. 安装 virtualenv 和 virtualenvwrapper，后者是一套很有用的扩展，提供了方便切换开发环境的快捷命令

以下命令都是基于Ubuntu的（Mac OS 上可以参考 https://gist.github.com/1208841 ）

sudo pip install virtualenv
sudo pip install virtualenvwrapper

#2 在用户的home目录下创建一个名为product的虚拟环境

export WORKON_HOME=~/envs
mkdir $WORKON_HOME
source /usr/local/bin/virtualenvwrapper.sh
mkvirtualenv --no-site-packages product #--no-site-packages 参数代表所有的Python包都从虚拟环境里找，任何时候都不去例如/usr/lib/python/这类全局环境里查找

这步完成后，就建立了一个名为product的虚拟环境目录，用workon product便能切换这个环境下，所谓切换，就是说这时候如果执行which python，就会发现现在的python不是/usr/bin/python，而是~/envs/product/bin/python，相应的所有的第三方python依赖也都在~/envs/product/lib/python2.7/site-packages/ 下。

#3 为了偷懒，可以在bashrc里建立一个alias，譬如

alias product='source ~/.bashrc; workon product; cd ~/envs/product/src'

alias stage='source ~/.bashrc; workon stage; cd ~/envs/stage/src'

这样执行product，stage就能分别切换到相应的虚拟工作环境，同时进入工作目录。

#4 未来要装相应的库，直接用pip即可，但是要确保pip也是相应的虚拟环境里的，可以用which pip检查，譬如要装django，就可以用

pip install django

pip也可以列出当前虚拟环境里所有的依赖，可以用这个办法将所有这些依赖写入一个文件，例如

pip freeze > product.dev

如果在另外一个环境里要重新安装这些依赖，执行

pip install -r product.dev

即可

cheka

2012-07-19 17:33:43 +08:00

@shitiven
直接把依赖代码塞项目目录下有不少弊病，譬如：

1. 项目目录下会有很多第三方代码库，譬如我们项目依赖近80个第三方库；
2. 工作环境复制会依赖文件拷贝，但是到了每个人手上，这些依赖就不好控制，有人会升级到最新版本，有人会用其他fork的版本，导致一旦出现问题难以查找；

另外，用virtualenv+uwsgi+nginx 还有额外好处，譬如同一台机器上可以建立几个virtualenv，里面可以有不同的依赖甚至代码分支，响应不同的端口号，这样一台机器就能同时提供生产环境和测试环境，在没有足够物理服务器或者不想折腾虚拟机的情况下，是个比较简单的方案。