从Flask 0.11版本开始，官方就建议使用flask run命令来取代app.run()方法运行开发服务器。尽管如此，两年多过去了，仍然有大量新发布的文章和教程在示例中使用app.run()方法启动程序。类似的，虽然内置的命令行支持已经非常完善，但还有很多人在使用Flask-Script。

Added flask and the flask.cli module to start the local debug server through the click CLI system. This is recommended over the old flask.run() method as it works faster and more reliable due to a different design and also replaces Flask-Script.

Flask Changelog 0.11

不得不承认，在某些特殊场景下，app.run()更加方便，比如创建Flask命令在附加Werkzeug提供的性能分析中间件后启动程序，这时通过app.run()可以直接在脚本内启动程序。但是在大多数情况下，flask run更能胜任启动开发服务器的工作。而且，在大型项目中，使用app.run()需要你在项目根目录单独创建一个启动脚本，flask run则没有这个要求；在单脚本程序中，使用flask run也可以省掉脚本末尾的两行代码。

注意 这两种方法都只是用来启动内置（Werkzeug提供）的开发服务器，仅适用于开发用途。在生产环境下，应该使用性能更好，更加完善的开发服务器，比如Gunicorn、uWSGI等。

不同组织形式的程序的启动方式

下面我们来了解一下使用flask run启动开发服务器时在几种方式。

简单的单脚本程序

如果脚本命名为app.py或wsgi.py，那么在包含程序脚本的目录下直接调用flask run即可：

$ flask run

Flask会自动探测找到脚本中的程序实例并启动。如果脚本命名为其他名称，比如hello.py，那么需要将脚本名写入环境变量FLASK_APP，然后再调用flask run命令：

$ export FLASK_APP=hello
$ flask run

提示 在Windows系统下，你需要使用set命令来设置环境变量，比如 > set FLASK_APP=hello，后面的命令亦同。

使用包组织的程序

这种情况下，可以将包含程序实例的对应模块的路径写入FLASK_APP：

$ export FLASK_APP=my_pkg.app
$ flask run

通常情况下，我们会在包内的__init__.py文件中创建程序实例，所以这时可以直接将包名称写入FLASK_APP：

$ export FLASK_APP=my_pkg
$ flask run

使用工厂函数创建程序实例的程序

因为Flask会自动探测程序实例，所以使用工厂函数创建程序实例时不需要进行额外设置。具体来说，Flask会在FLASK_APP变量存储的对应模块/包构造文件中寻找名为create_app或make_app的函数，并调用这个函数来创建一个程序实例。

为了让你的程序能够被探测到，工厂函数的名称需要命名为create_app或make_app，而且要确保工厂函数接受默认值参数。这时启动开发服务器的方式仍然不变：

$ export FLASK_APP=my_pkg
$ flask run

如果你的工厂函数接受的参数不是默认参数，或者你想详细定义调用工厂函数的方式，那么也可以通过FLASK_APP环境变量来定义：

$ export FLASK_APP="my_pkg:create_app('development')" 
$ flask run

提示 Flask的FLASK_APP还接受其他形式的输入值，你可以参考文末给出的文档相关部分链接了解完整内容。

如何避免重复设置FLASK_APP环境变量

在上面的几种方式中，除了包含程序实例的程序脚本命名为app.py或wsgi.py的情况外，都需要设置FLASK_APP环境变量。有没有办法避免重启电脑或是新打开命令行会话时重复输入FLASK_APP呢？当然。Flask提供了对一个常用的Python虚拟环境管理工具python-dotenv的支持，我们需要先安装它：

$ pip install python-dotenv

当python-dotenv安装后，执行flask run命令会首先将项目根目录下的.env和.flaskenv文件中的环境变量写入。所以，你可以将FLASK_APP写在这两个文件中。按照约定，.env存储包含敏感数据的环境变量，这个文件需要加入到.gitignore中以避免提交到Git仓库中；而.flaskenv时Flask特别支持的文件，这个文件则用来存储和Flask相关的环境变量，比如FLASK_ENV、FLASK_DEBUG等，所以我们可以把FLASK_APP写到这个文件中：

FLASK_APP=my_pkg

现在，我们可以仅通过一个命令来启动开发服务器：

$ flask run

使用flask run时如何开启调试模式？

在使用app.run()方法时，我们会通过将debug参数设为True来开启调试模式。而当使用flask run时，则需要通过FLASK_ENV环境变量来设置调试模式。默认情况下，FLASK_ENV的值为production，在开发时我们可以将其设为development来开启调试模式。

同样的，为了避免重复写入这个环境变量，我们也将其写到.flaskenv中：

FLASK_ENV=development

提示 目前已不推荐使用FLASK_DEBUG来开启调试模式，当FLASK_ENV的值为development时调试模式会自动开启。

使用flask run时如何自定义主机和端口

在通过flask run启动开发服务器时，你可以通过命令行选项来自定义监听的主机和端口，示例如下：

$ flask run --port 5001

下面的示例同时指定了端口和主机：

$ flask run --host 0.0.0.0 --port 5001

另外，Flask还支持通过环境变量来定义命令选项，支持的环境变量名称模式为“FLASK_命令_选项”。比如，如果你想设置端口，那么可以定义FLASK_RUN_PORT环境变量，作用和传入--port选项相同。

启动包含程序上下文的Python Shell

你可以通过flask shell命令来启动一个激活了程序上下文的Python Shell，而不是使用python命令：

$ flask shell

app.run()的未来

从0.11版本到现在的1.0.2版本，app.run()始终处于不建议使用状态，而且Flask的命令行系统、flask run命令的程序探测都在逐渐完善，我觉得未来也许会正式”deprecate“这个app.run()方法。不过，因为某些特殊用途仍然需要使用app.run()，未来的变化还不好说。而且，Miguel Grinberg提交了1个PR让app.run()间接调用flask run，如果这个PR被合并，也许app.run()将会重回正轨。

就目前来说，flask run要远比app.run()更加方便、好用、简洁、直观，准备好了吗？穿上新衣服吧。

相关链接

• Flask文档“程序发现”部分：Command Line Interface
• Flask Changelog：Flask Changelog – Flask 1.0.2 documentation

Jinja是组成Flask的模板引擎。可能你还不太了解它是干嘛的，但你对下面这些百分号和大括号肯定不陌生：

{% block body %}
  <ul>
  {% for user in users %}
    <li><a href="{{ user.url }}">{{ user.username }}</a></li>
  {% endfor %}
  </ul>
{% endblock %}

看过《Flask Web开发》，很多人都能写出来这些，但除了书里讲的，你还应该了解一些其他的语法细节。这篇文章就来介绍一些常用的语法和函数，如果想要系统完整的了解Jinja，可以去读它的文档：http://jinja.pocoo.org/docs/dev/。

FAQ

在Jinja网站上的FAQ里，我挑了三个大家可能会比较感兴趣的问题（简单翻译了一下）。

1、为什么要叫Jinja？

之所以叫Jinja，是因为日本的神社（Jinja）英文单词是temple，而模板的英文是template，两者发音很相似（这么说来，它本来也有可能叫Miao的……）。

2、Jinja的速度怎么样？

和Mako差不多，但比Genshi以及Django的模板引擎快10~20倍。

3、把逻辑判断（Logic）放到模板里是个好主意吗？

毫无疑问，你放到模板里逻辑判断（Logic）应该越少越好。但为了让大家都开心，适当的逻辑判断是需要的。尽管如此，它有很多对于你能做什么，不能做什么的限制。

出于诸多考虑（速度，易读性等等），Jinja既不允许你放置任意的Python代码，也不允许所有的Python表达式。这也是为什么我们要了解Jinja2的语法。

Delimiters（分隔符）

• {% … %} 语句（Statements）
• {{ … }} 打印模板输出的表达式（Expressions）
• {# … #} 注释
• # … ## 行语句（Line Statements）

多说一下注释，这是单行注释：

{#% for user in users %#}

下面是多行注释：

{# note: commented-out template because we no longer use this
    {% for user in users %}
        ...
    {% endfor %}
#}

Variables（变量）

除了普通的字符串变量，Jinja2还支持列表、字典和对象，你可以这样获取变量值：

{{ mydict['key'] }}
{{ mylist[3] }}
{{ mylist[myintvar] }}
{{ myobj.somemethod() }}

获取一个变量的属性有两种方式：

{{ foo.bar }}
{{ foo['bar'] }}

这两种方法基本相同（深层次的区别可以暂不考虑）

Filter（过滤器）

过滤器用来修改变量，使用一个竖线和变量相隔。

{{ items|join(', ') }}

常用的内置过滤器：

• safe 渲染时不转义
• capitalize 首字母大写
• lower 小写
• upper 大写
• title 每个单词的首字母都转换成大写
• trim 去掉首尾空格
• striptags 去掉值里的HTML标签
• default 设置一个默认值，如果变量未定义，就用这个默认值替换。类似这样：

{{ my_variable|default('my_variable is not defined') }}

• random(seq) 返回一个序列里的随机元素
• truncate(s, length=255, killwords=False, end=’…’) 截取出指定长度的文章（文章摘要）
• format(value, *args, **kwargs) 参考Python的字符串格式化函数
• ……

完整的fliter列表：http://jinja.pocoo.org/docs/dev/templates/#builtin-filters

Tests（测试，判断）

Jinja2提供的tests可以用来在语句里对变量或表达式进行测试，如果要测试一个变量，可以在变量后加上“is”和test名，比如：

{% if user.age is equalto 42 %} {# 这里也可以写成... is equalto(42) #}
    Ha, you are 42!
{% endif %}

如果要传入参数，可以在test后增加括号，也可以直接写在后面。

常用的test（未说明的均返回True或False）：

• defined
• equalto
• escaped
• none
• sequence
• string
• number
• reverse
• replace
• ……

完整的test列表及用法见：http://jinja.pocoo.org/docs/dev/templates/#list-of-builtin-tests

Loop（循环）

在一个for循环内，有一些特殊的变量可以使用，这是几个常用的：

• loop.index 当前迭代数，可以用来写评论的楼层数（从1开始）
• loop.index0 同上，不过从0开始迭代
• loop.revindex 反向的迭代数（基数为1）
• loop.revindex0 反向的迭代数（基数为0）
• loop.length 序列的数量
• loop.first 是否是第一个元素
• loop.last 是否是最后一个元素
• ……

完整的列表见：http://jinja.pocoo.org/docs/dev/templates/#for

Whitespace Control（空格控制）

默认的设置：

1. 如果末尾有换行符，则去除；
2. 其他空格原样保留。

也就是说，下面这几行：

<div>
    {% if True %}
        yay
    {% endif %}
</div>

渲染后的结果是这样：

<div>

        yay

</div>

Jinja2语句占据的空行，你自己输出的空格，Tab都将保留。

如果要去掉Jinja2语句占据的空行，可以通过设置Jinja2的环境变量实现：

app.jinja_env.trim_blocks = True
app.jinja_env.lstrip_blocks = True

或者像这样手动添加一个减号（注意和%之间没有空格）：

<div>
    {% if True -%}
        yay
    {%- endif %}
</div>

两者实现的效果相同，如下：

<div>

        yay

</div>

如果语句块的前后都加上减号：

<div>
    {%- if True -%}
        yay
    {%- endif -%}
</div>

渲染后会是这样：

<div>yay</div>

通过Jinja2提供的环境变量，你可以设置很多东西，比如分隔符（在和其他的语言产生冲突时，可以通过修改分隔符来解决）。具体见：http://jinja.pocoo.org/docs/dev/api/#jinja2.Environment

Escaping（转义）

有时你会想原样输出一些Jinja2语句和分隔符，对于小的内容，可以使用变量表达式来输出，比如输出一个分隔符：

{{ '{{' }}

大的内容块可以使用一个raw块包裹：

{% raw %}
    <ul>
    {% for item in seq %}
        <li>{{ item }}</li>
    {% endfor %}
    </ul>
{% endraw %}

模板继承

你可以创建一个base.html作为基模板，把导航栏、页脚、flash消息、js或css文件等等需要在每一个页面中显示的内容放在基模板里，然后在其他的模板（子模板）里使用这个语句继承它：

{% extends "base.html" %}

如果想添加内容到在父模板内已经定义的块，可以使用super函数：

{% block sidebar %}
    <h3>Table Of Contents</h3>
    ...
    {{ super() }}
{% endblock %}

这样可以避免覆盖父块的内容。

全局函数

常用的全局函数有：

• range([start, ]stop[, step])
• lipsum(n=5, html=True, min=20, max=100) 为模板生成一些 lorem ipsum。

详细列表见：http://jinja.pocoo.org/docs/dev/templates/#list-of-global-functions

其他内容

内容还有很多，比如行语句、控制流、表达式、宏等。不再一一介绍了（写这种介绍文章太累了……）。

具体见文档的模板部分：

Template Designer Documentation

相关链接

Jinja主页：http://jinja.pocoo.org

Jinja2文档：http://jinja.pocoo.org/docs/dev/

Jinja2文档模板部分：http://jinja.pocoo.org/docs/dev/templates/

Github项目页：https://github.com/pallets/jinja

– – – – –

更多关于Flask和Web开发的优质原创内容，欢迎关注Hello, Flask! – 知乎专栏。

Demo体验：猜数字 – Flask
难度：1
使用扩展：Flask-Bootstrap、Flask-WTF

本文首发于知乎专栏：Hello, Flask!

– – – – –

每个学编程的人大概都写过猜数字游戏，今天我们用Flask来做一个Web版本的猜数字。功能很简单，只有两个路由，三个模板和一个表单组成。扩展的版本见项目的Github页面（页尾）。

项目结构

|-GuesstheNumber 项目名称
    |-guess.py
    |-templates/  模板文件夹
        |-index.html  
        |-guess.html
        |-base.html  基模板
    |-venv/  虚拟环境

实现代码

guess.py

# -*- coding: utf-8 -*-
import random

from flask import Flask, render_template, flash, redirect, url_for, session
from flask_wtf import Form
from wtforms import IntegerField, SubmitField
from wtforms.validators import Required, NumberRange
from flask_bootstrap import Bootstrap

app = Flask(__name__)
app.config['SECRET_KEY'] = 'very hard to guess string'  #设置secret key
bootstrap = Bootstrap(app)  # 初始化Flask-Bootstap扩展


@app.route('/')
def index():
    # 生成一个0~1000的随机数，存储到session变量里。
    session['number'] = random.randint(0, 1000)  
    session['times'] = 10
    return render_template('index.html')


@app.route('/guess', methods=['GET', 'POST'])
def guess():
    times = session['times'] # 从session变量里获取次数
    # 从session变量里获取在index函数里生成的随机数字
    result = session.get('number')  
    form = GuessNumberForm()
    if form.validate_on_submit():
        session['times'] = times  # 更新次数值
        if times == 0:
            flash(u'你输啦……o(>﹏<)o')
            return redirect(url_for('.index'))
        answer = form.number.data
        if answer > result:
            flash(u'太大了！你还剩下%s次机会' % times)
        elif answer < result:
            flash(u'太小了！你还剩下%s次机会' % times)
        else:
            flash(u'啊哈，你赢了！V(＾－＾)V')
            return redirect(url_for('.index'))
    return render_template('guess.html', form=form)


class GuessNumberForm(Form):
    number = IntegerField(u'输入数字(0~1000)：', validators=[
        # 传入验证函数和相应的错误提示信息。
        Required(u'输入一个有效的数字！'),
        NumberRange(0, 1000, u'请输入0~1000以内的数字！')])
    submit = SubmitField(u'提交')


if __name__ == '__main__':  # 用于heroku部署，本地可省略
    app.run()

index.html

{% extends "base.html" %}

{% block page_content %}
<!-- 传入url_for的参数是视图函数的名称 -->
<a class="btn btn-success btn-lg" href="{{ url_for('guess') }}">开始游戏</a>
{% endblock %}

guess.html

{% extends "base.html" %} <!-- 引入基模板 -->
{% import "bootstrap/wtf.html" as wtf %}

{% block page_content %}
    <!-- 使用Flask-Bootstrap提供的函数来生成默认样式的表单 -->
    {{ wtf.quick_form(form) }}
{% endblock %}

完整的项目见源码（底部）。

相关知识

• session（会话）

session是Flask的上下文（context）全局变量，可以用来存储（用字典的形式）请求之间需要“记住”的值。在这个猜数字游戏里，我使用它来存储生成的随机数和剩余的机会次数。

要使用session，得先设置一个secret key，这用来给Cookie签名以加密session，这样做的效果是用户可以看到cookie但不能篡改它。尽管如此，session并不是安全的，不能用来存储密码，这个视频演示了一个破解session的过程：https://youtu.be/mhcnBTDLxCI。

更多细节见：http://flask.pocoo.org/docs/0.11/quickstart/#sessions

安装和运行

源码地址：https://github.com/helloflask/guess-flask

下载或使用git命令克隆项目后，切换到程序根目录。使用virtualenv创建一个虚拟环境，激活后使用pip安装所需依赖：

pip install -r requirements.txt

然后运行：

set FLASK_APP=guess.py    
flask run

访问： http://127.0.0.1:5000/

上面的代码稍微美化一下，变成了下面这样：

源码：https://github.com/helloflask/guess

Demo：http://guessguess.herokuapp.com/