第 1 章:Flask 还值不值得学
2026 年还在讲 Flask,不是因为怀旧,而是因为仍然有大量存量项目,以及一批"只要一个接口就够"的场景。
学习目标
- 说清 Flask 的定位:微框架、WSGI、同步
- 知道它和 FastAPI 该怎么分工,不再纠结"选哪个"
- 跑起第一个应用,看懂一个请求是怎么被处理的
- 认出什么场景不该用 Flask
1.1 它的定位:微框架
Flask 的两个关键词:
| 关键词 | 含义 |
|---|---|
| 微框架 | 核心只有路由、请求、响应、模板;数据库、表单、认证全靠扩展 |
| WSGI | 同步的 Python Web 网关接口,一个请求占一个线程直到处理完 |
由此带来两个直接后果:
- 上手极快:一个文件、十行代码就能跑;
- 上限取决于你组装的扩展:它不替你做架构决策,你把项目长成什么样,它就长成什么样。
它的依赖也很干净:Werkzeug 负责 WSGI 与请求解析,Jinja2 负责模板,两者都是 Pallets 自家项目。
1.2 和 FastAPI 的分工
这两者不是"新旧替代",而是两种取舍:
| 维度 | Flask | FastAPI |
|---|---|---|
| 协议 | 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 flaskpython
# 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,这个默认行为省掉了不少样板代码。
三个细节值得记住:
Flask(__name__)里的名字决定它去哪里找模板和静态文件;@app.get是 Flask 2.0 之后的快捷写法,等价于@app.route("/", methods=["GET"]);--debug打开热重载与调试器,只在本机用,绝不能上生产。
1.4 一个请求是怎么走完的
这张图解释了后面很多坑的来源: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 而不是手拼字符串。