×

Flask Web框架入门

Flask Web框架入门

0. 准备工作

1. Flask简介

  • Flask是一个轻量级的Python Web框架,非常适合快速开发Web应用。

  • Flask是一个用Python编写的Web应用程序框架。它由Armin Ronacher开发,他领导着一个名为Pocco的Python爱好者的国际组织。Flask基于Werkzeug WSGI工具包和Jinja2模板引擎。

2. 快速开始

2.1 最小应用

一个最小的应用,可以像下面这样,将以下内容保存到app.py文件中

1
2
3
4
5
6
7
from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return '<p>Hello, World!</p>'

然后在pycharm终端运行flask run命令,就可以启动一个web应用服务器。

Snipaste_2026-08-13_15-11-42.png

然后,在浏览器打开http://localhost:5000/,就可以看到页面:

Snipaste_2026-08-13_16-08-30.png

在Flask中使用route()装饰器将一个函数绑定到对应的URL上。@app.route()装饰器相当于MVC模型中的Control控制层。

@app.route()装饰器下面的函数,当浏览器中处理的请求符合路由规则时,就会进入到函数中,这里的函数相同于MVC模型中的Model模型层。

return后面返回字符会返回到用户浏览器显示出来,当使用render_template()方法构建HTML视图模板时,视图模板就相当于MVC模型中的View视图层。

除了使用flask run启动应用外,也可以使用以下命令:

  • python -m flask run。
  • flask --app app run,指定应用名称是app,指代的是app.py这个文件,不要将文件名命名为flask.py,这样会与Flask框架冲突。

2.2 Debug调试模式

Flask可以开启Debug调试模式,这样当代码发生变化时,能自动重新加载服务。同时,如果代码有异常时,会自动在页面上面显示出来。

  • 只需要在启动flask应用时,增加--debug参数即可。如flask run --debug。

Snipaste_2026-08-14_15-37-09.png

如果我将World替换成flask,则可以看到控制台自动重新加载,然后刷新页面可以看到页面已经发生了变化。

Snipaste_2026-08-14_19-42-25.png

  • 调试器允许从浏览器执行任意 Python 代码。它受 PIN 码保护,但依然存在重大安全风险。切勿在生产环境运行开发服务器或调试器。

2.3 HTML转义

当渲染用户输入时,应对用户的输入字符进行黑底,避免注入攻击。后面使用的Jinja来渲染HTML模板时会自动转义。

以下示例是直接访问用户输入的代码:

1
2
3
4
5
6
7
8
9
from flask import Flask, request

app = Flask(__name__)


@app.route('/hello')
def hello():
    name = request.args.get('name', 'Flask')
    return f'<p>Hello, {name}!</p>'

然后用户访问URL http://localhost:5000/hello?name=%3Cscript%3Ealert(%22bad%22)%3C/script%3E, 它会在浏览器端执行恶意JavaScript代码 ,输出如下:

Snipaste_2026-08-14_20-06-53.png

当开发者不慎将用户输入直接拼接到模板字符串中(而非作为变量传递)时,攻击者就可以在服务端执行任意代码。

因此,我们应对用户输入进行转义。

优化后代码如下:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
from flask import Flask, request
from markupsafe import escape

app = Flask(__name__)


@app.route('/hello')
def hello():
    name = request.args.get('name', 'Flask')
    return f'<p>Hello, {escape(name)}!</p>'

此时再访问相同的URL地址时,不会执行JavaScript代码,而是正常输出字符:

Snipaste_2026-08-14_20-09-54.png

3. 路由Route

现代的web应用会使用有意义的URL地址来帮助用户,用户也更喜欢一些有意义的URL,这样他们可以记住并且直接通过URL来访问页面。

  • 使用route()装饰器来为一个URL绑定一个功能函数。

如下示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
from flask import Flask

app = Flask(__name__)


@app.route('/')
def index():
    return 'Index Page'

@app.route('/hello')
def hello():
    return 'Hello, World'

你还可以实现更多功能!你可以将 URL 的部分内容设置为动态参数,并且可以为同一个函数绑定多条路由规则。

3.1 变量规则

你可以通过<variable_name>的标记方式,为 URL 添加变量段。随后视图函数会将该变量作为关键字参数接收。你还可以选择使用转换器指定参数类型,格式为<converter:variable_name>。

以下是不同变量的示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
from flask import Flask
from markupsafe import escape

app = Flask(__name__)


@app.route('/user/<username>')
def show_user_profile(username):
    # show the user profile for that user
    return f'User {escape(username)}'

@app.route('/post/<int:post_id>')
def show_post(post_id):
    # show the post with the given id, the id is an integer
    return f'Post {post_id}'

@app.route('/path/<path:subpath>')
def show_subpath(subpath):
    # show the subpath after /path/
    return f'Subpath {escape(subpath)}'

可转换的类型:

序号类型说明
1string默认类型,接受任何不包含/斜杠的字符串
2int正整数
3float正浮点数
4path像string类型一样,但接受/斜杠的字符串
5uuid接收UUID字符串

访问不同页面的输出如下:

Snipaste_2026-08-14_20-48-07.png

可以看到变量能正常渲染。

3.2 唯一URL

以下两个路由规则不同点是结尾处是不是包含斜杠/:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
from flask import Flask

app = Flask(__name__)


@app.route('/projects/')
def projects():
    return 'The project page'

@app.route('/about')
def about():
    return 'The about page'
  • projects 端点的规范 URL 末尾带有斜杠,类似文件系统里的文件夹。如果你访问不带末尾斜杠的地址 /projects,Flask 会自动重定向到带斜杠的规范地址 /projects/。

  • about 端点的规范 URL 末尾不带斜杠,类似文件的路径名。访问带斜杠的 /about/ 会返回 404。这样保证资源 URL 唯一,避免搜索引擎把同一个页面收录两次。

Snipaste_2026-08-14_21-03-06.png

Licensed under the GNU General Public License v3.0
最后更新于 2026年08月14日 21:21