Flask-Migrate的使用

组织一个 Flask 项目通常需要遵循一定的结构,以便代码清晰、可维护。下面是一个典型的 Flask 项目结构:

python 复制代码
my_flask_app/
│
├── app/
│   ├── __init__.py
│   ├── models.py
│   ├── views.py
│   ├── forms.py
│   ├── templates/
│   │   ├── base.html
│   │   ├── index.html
│   └── static/
│       ├── css/
│       ├── js/
│       └── images/
│
├── migrations/
│
├── tests/
│   ├── __init__.py
│   ├── test_app.py
│
├── venv/
│
├── config.py
│
├── manage.py
│
├── requirements.txt
│
└── README.md

目录和文件说明

app/
  • __init__.py: 初始化 Flask 应用,注册蓝图和扩展。
  • models.py: 数据库模型定义。
  • views.py: 视图函数,处理路由和请求。
  • forms.py: 表单定义(如果使用 Flask-WTF)。
  • templates/: HTML 模板文件。
  • static/: 静态文件(CSS、JavaScript、图像等)。
migrations/
  • 数据库迁移文件夹,用于存储 Alembic 生成的迁移脚本。
tests/
  • 测试代码文件夹。
venv/
  • 虚拟环境文件夹。
config.py
  • 配置文件,存储应用配置变量。
manage.py
  • 管理脚本,用于启动应用和其他管理任务。
requirements.txt
  • 依赖文件,列出所有需要安装的 Python 包。
README.md
  • 项目说明文件,提供项目的基本信息和使用说明。

1. 安装:

pip install Flask-Migrate

2. 使用

2.1 在 app.py文件中

复制代码
from flask_migrate import Migrate

# 创建迁移对象
migrate = Migrate(app, db)

2.2 在 项目拆分文件中 app/init.py

python 复制代码
# app/__init__.py

from .app import create_app

2.3 在 项目拆分文件中 app/app.py

python 复制代码
# app/app.py

from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

from config.Config import DevelopmentConfig  # 导入配置
from .views import author  # 导入author蓝图

# 实例 db migeate
db = SQLAlchemy()
migrate = Migrate()


# 创建app
def create_app():
    # 实例app
    app = Flask(__name__)
    
    # 配置
    app.config.from_object(DevelopmentConfig)
    
    # 初始化 db migrate
    db.init_app(app)
    migrate.init_app(app, db)
    
    # 注册蓝图
    app.register_blueprint(author)
    
    # 返回app
    return app

3. 迁移

3.1 查看帮助

python 复制代码
flask db --help
  • 3.2 初始化,只需要一次,创建一个目录migrations,用于存放迁移相关的脚本文件

    flask db init

  • 3.3 根据模型与数据表,创建迁移脚本

    flask db migrate

  • 3.4 执行迁移脚本

    flask db upgrade

4. 提示

  • 初始化只需要执行一次,以后操作2和3反复执行
  • 不是每次迁移都会成功,出问题时手动解决
相关推荐
love530love1 小时前
ComfyUI 升级 v0.4.0 踩坑记录:解决 TypeError: QM_Queue.task_done() 报错
人工智能·windows·python·comfyui
粟悟饭&龟波功1 小时前
【GitHub热门项目精选】(2025-12-19)
前端·人工智能·后端·github
不思念一个荒废的名字1 小时前
【黑马JavaWeb+AI知识梳理】Web后端开发04-登录认证
java·后端
阿坤带你走近大数据1 小时前
Python基础知识-数据结构篇
开发语言·数据结构·python
小智RE0-走在路上1 小时前
Python学习笔记(7)--集合,字典,数据容器总结
笔记·python·学习
沃斯堡&蓝鸟1 小时前
DAY 29 异常处理
python
Direction_Wind2 小时前
抓包的使用与讲解
python
职业码农NO.12 小时前
智能体推理范式: Plan-and-Execute(规划与执行)
人工智能·python·数据分析·系统架构·知识图谱·agent·集成学习
爱笑的眼睛112 小时前
超越`cross_val_score`:深入剖析Scikit-learn交叉验证API的设计哲学与高阶实践
java·人工智能·python·ai
平凡运维之路2 小时前
Linux入侵挖矿处理记录
后端