安装¶
Flask依赖两个外部库:Werkzeug和Jinja2。 Werkzeug 是一个 WSGI(在 Web 应用和多种服务器之间的标准 Python 接口) 工具 集。 Jinja2 负责渲染模板。
那么如何在你的电脑上安装这一切? 虽说条条大道通罗马,但是最强大的方式是 virtualenv ,所以我们首先来看它。
你首先需要 Python 2.6 或更高的版本,所以请确认有一个最新的 Python 2.x 安装。 在 Python 3 中使用 Flask 请参考: Python 3 支持 。
virtualenv ¶
你很可能想在开发中用上 virtualenv,如果你有生产环境的 shell 权限,你同样 会乐于在生产环境中使用它。
virtualenv 解决了什么问题? 如果你像我一样喜欢 Python,不仅会在采用 Flask 的Web 应用中用上 virtualenv,在别的项目中你也会想用上它。 你拥有的项目越 多,同时使用不同版本的 Python 工作的可能性也就越大,或者起码需要不同版本 的 Python 库。 悲惨的现实是:常常会有库破坏向后兼容性,然而正常的应用不采用外部库的可能微乎其微。当在你的项目中,出现两个或更多依赖性冲突时,你会怎么做?
virtualenv 拯救世界! 它并 没有真正安装多个 Python 副本,但是它确实提供了一种巧妙的方式来让各项目环 境保持独立。 假设你使用 Python 2.7 且为默认目录,添加下面的值: 让我们来看看 virtualenv 是怎么工作的。
如果你在 Mac OS X 或 Linux 下,下面两条命令可能会适用:
$ sudo pip install virtualenv
上述的命令会在你的系统中安装 virtualenv。 它甚至可能会存在于包管理器中。如果你用的是 Ubuntu,可以尝试:
$ sudo apt-get install python-virtualenv
如果你用的是 Windows ,而且没有 easy_install
命令,那么你必须先安装这个命令。 查阅 Windows 下的 pip 和 distribute 章节了解如何安装。 之后,运行上述的命令,但是要去掉 sudo
前缀。
virtualenv 安装完毕后,你可以立即打开 shell 然后创建你自己的环境。 我通常创建一个项目文件夹,并在其下创建一个venv
文件夹:
$ mkdir myproject
$ cd myproject
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.
现在,无论何时你想在某个项目上工作,只需要激活相应的环境。 在 OS X 和 Linux 上,执行如下操作:
$ . venv/bin/activate
下面的操作适用 Windows:
$ venv\Scripts\activate
无论通过哪种方式,你现在应该已经激活了 virtualenv(注意你的 shell 提示符 显示的是当前活动的环境)。
如果想回到真实的世界,请使用下面的命令:
$ deactivate
之后,shell提示符应该回到和以前一样。
现在,让我们继续。键入以下命令来激活virtualenv中的Flask:
$ pip install Flask
几秒钟后,一切都搞定了。
全局安装¶
这样也是可以的,虽然我不推荐。 只需要以root权限运行pip
:
$ sudo pip install Flask
(在 Windows 上,在管理员权限的命令提示符中去掉sudo
运行这条命令。)
活在边缘¶
如果你需要最新版本的Flask,有两种方法:你可以使用pip
拉取开发版本, 或让它操作一个git checkout。 无论哪种方式,依然推荐使用 virtualenv。
在一个全新的 virtualenv 中 git checkout 并运行在开发模式下:
$ git clone http://github.com/pallets/flask.git
Initialized empty Git repository in ~/dev/flask/.git/
$ cd flask
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.
$ . venv/bin/activate
$ python setup.py develop
...
Finished processing dependencies for Flask
这会拉取依赖并激活 git head 作为 virtualenv 中的当前版本。 然后你只需要执 行 git pull origin
来升级到最新版本。
Windows下的pip和setuptools¶
有时候,获取标准的“Python包工具”如pip
, setuptools
和virtualenv
可能有点麻烦,但一点也不难。关键的包是pip,其它的包(如virtualenv)都需要它安装。幸运的是,有个“安装脚本”可以直接运行来安装。
如果你当前没有pip
,那么 get-pip.py将会为你安装一个。
它下载下来后应该可以双击。如果你已经安装pip
,可以通过执行以下命名来升级它们:
> pip install --upgrade pip setuptools
在大部分时候,一旦打开命令行你就能够输入pip
和python
来运行,但是在Windows上可能不行,因为它不知道这些可执行文件的位置(可以试一下!)。
若要修掉这个问题,你应该能够浏览到Python的安装目录(如C:Python27
),然后是Tools
,再然后是Scripts
,最后找到win_add2path.py
文件并运行它。打开一个新的命令行,检查一下可以只用输入python
就可以调用解释器。
最后,你可以简单地运行来安装virtualenv:
> pip install virtualenv
然后,你就可以结束上面的安装指南了。