改了模型字段(比如加一个 priority 列),数据库不会自动更新。Alembic 负责生成和执行迁移脚本。
uv add alembic
# 初始化
alembic init alembic
# 配置 alembic.ini
# sqlalchemy.url = sqlite:///todo.db
# 配置 alembic/env.py 的 target_metadata
# from models import Base
# target_metadata = Base.metadata
# 自动生成迁移脚本(对比模型和数据库差异)
alembic revision --autogenerate -m "add priority column"
# 执行迁移
alembic upgrade head
# 回退一个版本
alembic downgrade -1
# 查看历史
alembic history
# 查看当前版本
alembic current
# models.py
class Todo(Base):
priority: Mapped[str] = mapped_column(String(20), default="medium")
# 然后执行
# alembic revision --autogenerate -m "add priority"
# alembic upgrade head
# 每次改模型都要生成迁移
alembic downgrade -1
# 检查数据库列是否回退了
# 开发时可以反复 upgrade/downgrade
alembic history --verbose
# 每个版本有一个 hash ID