虚拟环境
虚拟环境是一个将不同项目所需求的依赖分别放在独立的地方的一个工具,它给这些工程创建虚拟的Python环境。它解决了“项目X依赖于版本1.x,而项目Y需要项目4.x”的两难问题,而且使你的全局site-packages目录保持干净和可管理。
比如,你可以工作在一个需求Django 1.3的工程,同时维护一个需求Django 1.0的工程。
virtualenv
virtualenv是一个创建隔绝的Python环境的工具。virtualenv创建一个包含所有必要的可执行文件的文件夹,用来使用Python工程所需的包。
通过pip安装virtualenv:
$ pip install virtualenv
基本使用
为一个工程创建一个虚拟环境:$ cd my_project_folder$ virtualenv venv
virtualenvvenv
将会在当前的目录中创建一个文件夹,包含了Python可执行文件,以及pip
库的一份拷贝,这样就能安装其他包了。虚拟环境的名字(此例中是venv
)可以是任意的;若省略名字将会把文件均放在当前目录。
在任何你运行命令的目录中,这会创建Python的拷贝,并将之放在叫做venv
的文件中。
你可以选择使用一个Python解释器:
$ virtualenv -p /usr/bin/python2.7 venv
这将会使用/usr/bin/python2.7
中的Python解释器。
要开始使用虚拟环境,其需要被激活:
$ source venv/bin/activate
当前虚拟环境的名字会显示在提示符左侧(比如说(venv)你的电脑:你的工程用户名$)以让你知道它是激活的。从现在起,任何你使用pip安装的包将会放在``venv
文件夹中,与全局安装的Python隔绝开。
像平常一样安装包,比如:
$ pip install requests
如果你在虚拟环境中暂时完成了工作,则可以停用它:
$ deactivate
这将会回到系统默认的Python解释器,包括已安装的库也会回到默认的。
要删除一个虚拟环境,只需删除它的文件夹。(要这么做请执行rm-rfvenv
)
然后一段时间后,你可能会有很多个虚拟环境散落在系统各处,你将有可能忘记它们的名字或者位置。
其他注意
运行带--no-site-packages
选项的virtualenv
将不会包括全局安装的包。这可用于保持包列表干净,以防以后需要访问它。(这在virtualenv
1.7及之后是默认行为)
为了保持你的环境的一致性,“冷冻住(freeze)”环境包当前的状态是个好主意。要这么做,请运行:
$ pip freeze > requirements.txt
这将会创建一个requirements.txt
文件,其中包含了当前环境中所有包及各自的版本的简单列表。你可以使用 “pip list”在不产生requirements文件的情况下,查看已安装包的列表。这将会使另一个不同的开发者(或者是你,如果你需要重新创建这样的环境)在以后安装相同版本的相同包变得容易。
$ pip install -r requirements.txt
这能帮助确保安装、部署和开发者之间的一致性。
最后,记住在源码版本控制中排除掉虚拟环境文件夹,可在ignore的列表中加上它。
virtualenvwrapper
virtualenvwrapper提供了一系列命令使得和虚拟环境工作变得愉快许多。它把你所有的虚拟环境都放在一个地方。
安装(确保virtualenv已经安装了):
$ pip install virtualenvwrapper$ export WORKON_HOME=~/Envs$ source /usr/local/bin/virtualenvwrapper.sh
(virtualenvwrapper 的完整安装指引.)
对于Windows,你可以使用virtualenvwrapper-win。
To install (make surevirtualenvis already installed): 安装(确保virtualenv已经安装了):
$ pip install virtualenvwrapper-win
在Windows中,WORKON_HOME默认的路径是 %USERPROFILE%Envs 。
基本使用
创建一个虚拟环境:$ mkvirtualenv venv
这会在~/Envs
中创建venv
文件夹。
在虚拟环境上工作:
$ workon venv
或者,你可以创建一个项目,它会创建虚拟环境,并在$PROJECT_HOME
中创建一个项目目录。当你使用workonmyproject
时,会cd
-ed 到项目目录中。
$ mkproject myproject
virtualenvwrapper提供环境名字的tab补全功能。当你有很多环境,并且很难记住它们的名字时,这就显得很有用。
workon
也能停止你当前所在的环境,所以你可以在环境之间快速的切换。
停止是一样的:
$ deactivate
删除:
$ rmvirtualenv venv
0x04 virtualenvwrapper 切换版本
virtualenvwrapper是管理Python虚拟环境的工具,可以很方便的为不同的项目建立独立的环境,每个项目都可以安装自己的依赖,同时也支持在不同的虚拟环境中存在不同版本的Python。
首先安装virtualenvwrapper,可以选择apt安装或者pip安装
apt安装
$ sudo apt-get install virtualenvwrapper
pip安装
$ sudo pip install virtualenvwrapper
当你需要使用Python2开发项目时,建立一个Python2的虚拟环境:
$ mkvirtualenv -p /usr/bin/python2 env27
当你需要Python3开发时:
$ mkvirtualenv -p /usr/bin/python3.4 env34
然后可以随时切换不同的虚拟环境:
$ workon env27 # 进入Python2环境$ workon env34 # 进入Python3环境
更爽的是,你可以在进入虚拟环境的同时切换到项目目录,只需要编辑$VIRTUAL_ENV/bin/postactivate
这个文件即可:
$ vim $VIRTUAL_ENV/bin/postactivate #前提是已经进入对应的虚拟环境
在文件中添加切换目录的命令:
cd /path/to/your/project
其他有用的命令
lsvirtualenv
列举所有的环境。cdvirtualenv
导航到当前激活的虚拟环境的目录中,比如说这样你就能够浏览它的site-packages
。cdsitepackages
和上面的类似,但是是直接进入到site-packages
目录中。lssitepackages
显示site-packages
目录中的内容。virtualenvwrapper 命令的完全列表。
virtualenv-burrito
有了virtualenv-burrito,你就能使用单行命令拥有virtualenv + virtualenvwrapper的环境。
autoenv
当你cd
进入一个包含.env
的目录中,就会autoenv自动激活那个环境。
使用brew
在Mac OS X上安装它:
$ brew install autoenv
在Linux上:
$ git clone git:///kennethreitz/autoenv.git ~/.autoenv$ echo 'source ~/.autoenv/activate.sh' >> ~/.bashrc