Flask Web框架入门
0. 准备工作
- python安装,可以在这里https://www.python.org/downloads/ 下载Python安装包,我下载3.11.8这个版本。
- flask安装,使用
pip install flask==3.1.2命令安装flask依赖包。 - pycharm安装,可以在这里https://www.jetbrains.com/zh-cn/pycharm/下载。
1. Flask简介
Flask是一个轻量级的Python Web框架,非常适合快速开发Web应用。
Flask是一个用Python编写的Web应用程序框架。它由Armin Ronacher开发,他领导着一个名为Pocco的Python爱好者的国际组织。Flask基于Werkzeug WSGI工具包和Jinja2模板引擎。
2. 快速开始
2.1 最小应用
一个最小的应用,可以像下面这样,将以下内容保存到app.py文件中
| |
然后在pycharm终端运行flask run命令,就可以启动一个web应用服务器。

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

在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。

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

- 调试器允许从浏览器执行任意 Python 代码。它受 PIN 码保护,但依然存在重大安全风险。切勿在生产环境运行开发服务器或调试器。
2.3 HTML转义
当渲染用户输入时,应对用户的输入字符进行黑底,避免注入攻击。后面使用的Jinja来渲染HTML模板时会自动转义。
以下示例是直接访问用户输入的代码:
| |
然后用户访问URL http://localhost:5000/hello?name=%3Cscript%3Ealert(%22bad%22)%3C/script%3E, 它会在浏览器端执行恶意JavaScript代码 ,输出如下:

当开发者不慎将用户输入直接拼接到模板字符串中(而非作为变量传递)时,攻击者就可以在服务端执行任意代码。
因此,我们应对用户输入进行转义。
优化后代码如下:
| |
此时再访问相同的URL地址时,不会执行JavaScript代码,而是正常输出字符:

3. 路由Route
现代的web应用会使用有意义的URL地址来帮助用户,用户也更喜欢一些有意义的URL,这样他们可以记住并且直接通过URL来访问页面。
- 使用
route()装饰器来为一个URL绑定一个功能函数。
如下示例:
| |
你还可以实现更多功能!你可以将 URL 的部分内容设置为动态参数,并且可以为同一个函数绑定多条路由规则。
3.1 变量规则
你可以通过<variable_name>的标记方式,为 URL 添加变量段。随后视图函数会将该变量作为关键字参数接收。你还可以选择使用转换器指定参数类型,格式为<converter:variable_name>。
以下是不同变量的示例:
| |
可转换的类型:
| 序号 | 类型 | 说明 |
|---|---|---|
| 1 | string | 默认类型,接受任何不包含/斜杠的字符串 |
| 2 | int | 正整数 |
| 3 | float | 正浮点数 |
| 4 | path | 像string类型一样,但接受/斜杠的字符串 |
| 5 | uuid | 接收UUID字符串 |
访问不同页面的输出如下:

可以看到变量能正常渲染。
3.2 唯一URL
以下两个路由规则不同点是结尾处是不是包含斜杠/:
| |
projects 端点的规范 URL 末尾带有斜杠,类似文件系统里的文件夹。如果你访问不带末尾斜杠的地址
/projects,Flask 会自动重定向到带斜杠的规范地址/projects/。about 端点的规范 URL 末尾不带斜杠,类似文件的路径名。访问带斜杠的
/about/会返回 404。这样保证资源 URL 唯一,避免搜索引擎把同一个页面收录两次。
