Skip to content
Lv3Flask 速成进度 1 / 8

第 1 章:Flask 还值不值得学 ​

2026 年还在讲 Flask,不是因为怀旧,而是因为仍然有大量存量项目,以及一批"只要一个接口就够"的场景。


学习目标 ​

  • 说清 Flask 的定位:微框架、WSGI、同步
  • 知道它和 FastAPI 该怎么分工,不再纠结"选哪个"
  • 跑起第一个应用,看懂一个请求是怎么被处理的
  • 认出什么场景不该用 Flask

1.1 它的定位:微框架 ​

Flask 的两个关键词:

关键词含义
微框架核心只有路由、请求、响应、模板;数据库、表单、认证全靠扩展
WSGI同步的 Python Web 网关接口,一个请求占一个线程直到处理完

由此带来两个直接后果:

  • 上手极快:一个文件、十行代码就能跑;
  • 上限取决于你组装的扩展:它不替你做架构决策,你把项目长成什么样,它就长成什么样。

它的依赖也很干净:Werkzeug 负责 WSGI 与请求解析,Jinja2 负责模板,两者都是 Pallets 自家项目。


1.2 和 FastAPI 的分工 ​

这两者不是"新旧替代",而是两种取舍:

维度FlaskFastAPI
协议WSGI(同步)ASGI(原生异步)
数据校验自己写或装扩展Pydantic 内置
接口文档需扩展自动生成 OpenAPI
学习曲线更平缓要懂类型标注与异步
生态成熟度十几年积累,扩展极多近年增长快,AI 场景多
典型场景存量项目、小工具、服务端渲染页面、内部管理后台新写的高并发 API、AI 服务、需要文档的对外接口

判断标准很朴素:

  • 要写页面(返回 HTML) → Flask 更顺,Jinja2 是一等公民;
  • 要写纯 API 且要求自动文档 → FastAPI 更省事;
  • 接手别人的老项目 → 大概率是 Flask,先把它的模式搞懂。

本站两门课都写,不是为了让你二选一,而是让你在两个仓库之间切换时不至于卡住。


1.3 第一个应用 ​

bash
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install flask
python
# app.py
from flask import Flask

app = Flask(__name__)

@app.get("/")
def index():
    return "Hello, Flask"

@app.get("/health")
def health():
    return {"status": "ok"}
bash
flask --app app run --debug

打开 http://127.0.0.1:5000,第一行返回文本,第二行返回 JSON——Flask 会自动把字典转成 JSON,这个默认行为省掉了不少样板代码。

三个细节值得记住:

  1. Flask(__name__) 里的名字决定它去哪里找模板和静态文件;
  2. @app.get 是 Flask 2.0 之后的快捷写法,等价于 @app.route("/", methods=["GET"]);
  3. --debug 打开热重载与调试器,只在本机用,绝不能上生产。

1.4 一个请求是怎么走完的 ​

从 TCP 到返回值,中间隔了四层浏览器HTTP 请求WSGI ServerGunicorn / WerkzeugFlask 应用路由匹配 + 请求上下文视图函数你的业务代码响应每一层各自负责什么WSGI Server:接收 TCP、解析成 environ 字典、把返回值写回连接Flask:按 URL 规则找到视图;把请求压进 request;异常转成错误响应视图函数:只关心业务;返回字符串、字典、元组或 Response中间件 / 钩子:before_request、after_request、teardown,横切关注点放这里关键认知:Flask 自己不是服务器。开发时 flask run 用的是 Werkzeug 的简易服务器,生产必须换成 Gunicorn / uWSGI / waitress。

这张图解释了后面很多坑的来源:app 对象是"应用",不是"服务器";flask run 只是方便你开发。


1.5 开发环境与生产环境 ​

两条路径的差别不是"命令不同",而是能力不同:

开发生产
服务器Werkzeug(单进程、带调试器)Gunicorn / waitress(多 worker、超时、优雅重启)
并发基本没有多 worker 或多线程
静态文件Flask 自己发Nginx 直接发,更快
HTTPS无Nginx 终止 TLS
出错页面显示调用栈记日志,返回 500

Windows 上没有 Gunicorn(它依赖 fcntl),生产用 waitress。


1.6 什么场景不该用它 ​

场景为什么不合适
长连接、WebSocket 为主WSGI 模型不适合,选 ASGI 框架
单机几万并发同步模型要堆进程/线程,成本高
需要自动生成对外 API 文档要额外装扩展,不如 FastAPI 直接
团队已经全栈 FastAPI增加一种框架只增加维护成本

反过来说,下面这些场景它还很好用:

  • 内部管理后台、运营工具,页面为主;
  • 给已有 Python 脚本套一个 HTTP 入口;
  • 存量项目维护与二次开发;
  • 教学与原型:从零到能访问,十分钟。

本章小结 ​

要点说明
定位微框架 + WSGI 同步
依赖Werkzeug(协议)+ Jinja2(模板)
与 FastAPI页面选 Flask,纯 API 选 FastAPI,老项目多半是 Flask
第一个应用一个文件、一个 Flask(__name__)、一个路由
请求链路服务器 → Flask(路由/上下文)→ 视图 → 响应
开发与生产flask run 只能开发用,生产换 Gunicorn / waitress

下一章 ​

路由:URL 规则怎么写、路径参数怎么约束、为什么要用 url_for 而不是手拼字符串。

本文阅读--次|全站访问--次|访客--人