Flask-SQLAlchemy：给 Flask 配一个靠谱的 ORM

Flask-SQLAlchemy：给 Flask 配一个靠谱的 ORM

Flask 是个轻量 Web 框架，本身不带 ORM。要用数据库，最常见的选择就是 SQLAlchemy。但 SQLAlchemy 的原生配置和 Flask 配合起来，有不少样板代码要写。Flask-SQLAlchemy 就是来解决这个问题的，目前 Star 数 4314，属于 Pallets 社区生态项目。

这个扩展的定位很清晰：降低 SQLAlchemy 接入 Flask 的成本，同时保留底层全部能力。

它帮你省掉了什么

Flask-SQLAlchemy 本质上是一个桥梁层。它把 SQLAlchemy 的能力接入 Flask，同时处理了很多琐碎的配置工作。

具体来说，主要有这几点：

自动管理数据库连接和 session 生命周期。在 Flask 的每个请求上下文中，session 自动创建和关闭，你不需要手动写 try/finally 或上下文管理器。

提供合理的默认配置。数据库 URI 从 Flask 的 app.config 里读取，模型基类可以自定义但不用重复声明。

兼容 SQLAlchemy 2.0 的新 API。示例代码用了 DeclarativeBase、Mapped、mapped_column，这些都是现代写法，类型提示也完整。

这些默认行为对小型项目和中型项目都够用。如果有特殊需求，底层 SQLAlchemy 的接口仍然可以访问。

代码风格

官方文档给了一个很简洁的示例。几行代码就能定义模型、创建表、插入数据、查询数据。

先定义模型基类，继承 DeclarativeBase。然后初始化 SQLAlchemy 实例，传入 Flask app 和模型基类。模型用 db.Model 做基类，字段用 mapped_column 声明，带类型提示。

查询语法也用了 SQLAlchemy 2.0 的 select 风格，db.select(User) 加上 db.session.scalars 执行，结果直接遍历。相比旧版的 query 接口，新写法更明确，类型检查也能覆盖到。

整个流程没有冗余配置，对新手来说门槛不高，对老手来说也不觉得受限。

社区背景

这个项目属于 Pallets Community Ecosystem。Pallets 是维护 Flask 本身的组织，Pallets-Eco 让社区参与扩展维护。这意味着项目的生命周期和 Flask 主项目有一定关联，不会随便弃坑。如果你在使用过程中发现问题，修复路径也比较清晰。

适合谁用

如果你已经在用 Flask，需要操作关系型数据库，又不想从零配置 SQLAlchemy，这个扩展可以省不少时间。

对初学者来说，它屏蔽了 session 管理的细节，起步更快。对老用户来说，它支持 SQLAlchemy 2.0 的新特性，不会拖后腿。

项目用的是 BSD 许可证，商用也没问题。4314 的 Star 数说明这个扩展已经被广泛使用，稳定性有一定保障。