Flask-Migrate：给 Flask 应用加上数据库迁移能力

用 Flask 做 Web 开发，数据库 schema 的变更是个绕不开的麻烦事。开发初期模型简单，直接删库重建就能继续。但项目上线后，表里有真实数据，再这么干就不现实了。Flask-Migrate 就是来解决这个问题的。它基于 Alembic，给 Flask 应用提供了一套数据库迁移机制，目前已经有 2,408 个 Star。

这个扩展的核心思路很简单：把数据库 schema 的变更记录下来，形成可复现的迁移脚本。每次模型有改动，生成一个新的迁移文件，里面包含了从旧 schema 到新 schema 的 DDL 操作。多人协作时，这些迁移文件可以提交到版本控制，其他人在本地执行升级命令就能同步数据库结构。

Flask-Migrate 的安装和使用都很直接。通过 pip 安装后，在应用代码里初始化：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///app.db'

db = SQLAlchemy(app)
migrate = Migrate(app, db)

然后就可以用 flask db 命令来管理迁移了。常用流程是三步：init、migrate、upgrade。

第一次使用时，执行 flask db init。这会在项目里创建一个 migrations 目录，用来存放迁移脚本。这个目录需要加到版本控制里。

模型有改动后，执行 flask db migrate。这会生成一个新的迁移脚本，里面是根据当前模型和数据库的差异自动生成的 DDL。不过这个脚本需要人工检查一遍，因为 Alembic 对索引变更的检测不够完善。表结构变更、新增字段这类常规操作，一般都能正确生成。

确认迁移脚本没问题后，执行 flask db upgrade，把变更应用到数据库。以后每次模型改动，重复 migrate 和 upgrade 两个步骤就行。

新环境部署时，只需要从版本控制拉取代码和 migrations 目录，然后执行 flask db upgrade，就能把数据库 schema 升级到最新版本。这比手动维护 SQL 脚本要省心不少。

这个工具的定位很明确：充当 Flask 和 Alembic 之间的桥梁，本身不实现独立的迁移逻辑。如果你已经在用 Flask-SQLAlchemy，接入成本很低。命令行接口也做得比较克制，没有堆砌太多功能，常用的操作都能在 flask db --help 里找到。

当然，Flask-Migrate 也有自己的局限。它只解决 schema 迁移的问题，数据迁移和 seed 数据初始化不在它的职责范围内。如果项目需要复杂的数据库版本策略，可能还得直接操作 Alembic 的底层 API。

整体来看，Flask-Migrate 解决的是一个具体且常见的问题。它的价值不在于技术创新，而在于把 Alembic 的能力以合适的方式融入了 Flask 生态。对于需要数据库版本管理的中小型 Flask 项目，它是一个务实的选择。

生态。对于需要数据库版本管理的中小型 Flask 项目，它是一个务实的选择。