Django、Flask、FastAPI 是适配不同场景的工具:Django适合需开箱即用功能的CMS/SaaS;Flask适合轻量HTTP接口;FastAPI适合异步高并发+强类型校验API。

选框架前先想清楚:你到底要跑什么服务
Django、Flask、FastAPI 不是“升级关系”,而是解决不同问题的工具。如果你要做带用户管理、后台、数据库迁移、权限控制的 CMS 或 SaaS 产品,Django 真的省心;如果只是写个内部 API、CLI 工具的 HTTP 接口,或者需要快速验证一个模型服务,Flask 上手快、没包袱;而如果你明确要异步支持高并发、用 Pydantic 做强类型校验、还要自动生成 OpenAPI 文档,FastAPI 是目前最顺手的选择。
常见错误现象:pip install flask 后发现连数据库迁移、用户登录都要自己拼轮子,最后代码里全是 if request.method == 'POST' 和手写的 SQL —— 这不是 Flask 的错,是你选错了场景。
- Django 自带
manage.py、admin、auth、migrations,开箱即用但定制成本高 - Flask 默认只有路由和请求对象,
request、render_template得自己配扩展(比如Flask-SQLAlchemy、Flask-Login) - FastAPI 强依赖
async def和Pydantic模型,同步代码得包一层run_in_executor,否则阻塞事件循环
路由和请求处理:别被装饰器语法骗了
三个框架都用装饰器注册路由,但语义和约束完全不同。Django 的 path() 和 re_path() 是 URL 路由优先级机制,Flask 的 @app.route() 是简单字符串匹配,FastAPI 的 @app.get() 则直接绑定 HTTP 方法 + 类型注解。
使用场景:你要做 RESTful 资源接口,FastAPI 的 @app.post("/items/") + 参数类型声明会自动校验 JSON body;Django 需要写 APIView 或 DRF 的 Serializer 才能拿到类似能力;Flask 则靠 request.get_json() + 手动 if not xxx: 判断。
立即学习“Python免费学习笔记(深入)”;
- Django 的
url(r'^user/(?P<id>\d+)/$')</id>写法已废弃,新版必须用path('user/<id>/', ...)</id> - Flask 中
@app.route('/api/<uid>')</uid>只做类型转换,不校验范围,uid=-1也能进函数 - FastAPI 的
def read_item(uid: int = Path(..., gt=0))会在 422 错误中直接返回字段级提示
数据库和 ORM:别急着写 Model
Django 的 models.Model 是强绑定设计,表结构变更必须走 makemigrations → migrate;Flask 几乎不碰 ORM,默认交由 SQLAlchemy,你可以用原生 SQL、Core 层或 ORM 层;FastAPI 完全不管——它只管 HTTP 层,ORM 是你自己的事,但社区普遍搭配 SQLModel 或 SQLAlchemy 2.0 的新式写法。
性能影响:Django 的 select_related() 和 prefetch_related() 能有效减少 N+1 查询,但写法固定;Flask + SQLAlchemy 需手动 join() 或 options(joinedload());FastAPI 里如果混用同步 ORM 和异步视图,容易卡住整个事件循环。
- Django 的
ForeignKey默认on_delete=models.CASCADE,不显式写会报错 - Flask-SQLAlchemy 的
db.create_all()不会更新已有表结构,改了 model 得用Flask-Migrate - FastAPI 配
SQLModel时,create_engine(..., echo=True)开启日志才看得到实际 SQL,否则调试像盲人摸象
部署和热重载:本地跑得欢,上线就出事
Django 自带 runserver 仅限开发,生产必须用 gunicorn + nginx;Flask 的 app.run(debug=True) 启用重载,但多进程下会重复初始化;FastAPI 的 uvicorn 支持 --reload,但只监听 Python 文件变化,模板或静态资源改了不会触发。
容易踩的坑:用 uvicorn main:app --reload 跑 FastAPI,结果在代码里写了 time.sleep(10),整个服务就卡死——因为 uvicorn 默认单 worker,同步阻塞等于拒绝所有请求。
- Django 部署前记得关掉
DEBUG=True,否则ALLOWED_HOSTS会拦掉所有外网请求 - Flask 在 Gunicorn 下启动时,
app.run()必须包裹在if <strong>name</strong> == '<strong>main</strong>':里,否则子进程重复执行 - FastAPI 的
lifespan机制(async def lifespan)用来管理 DB 连接池,但很多教程直接忽略,导致连接泄漏
Django 的约定太多,Flask 的自由太烫手,FastAPI 的类型太严格——选哪个不取决于流行度,而取决于你愿不愿意为它的约束买单。真正麻烦的从来不是框架本身,而是你一边写业务逻辑,一边还在纠结该用哪个 BaseModel 继承。










