Flask框架核心组件与项目结构实战指南

Ada

发布时间：2026-10-14| 3人浏览过

原创

本文详细解析了Flask官方推荐的目录结构，包括蓝图（Blueprint）的注册与应用工厂模式。接着介绍了如何集成Flask-SQLAlchemy进行数据库操作，利用Flask-Script实现命令行启动与自定义脚本，并通过Flask-Migrate完成数据库迁移。涵盖从项目搭建到数据库管理的完整流程，适合Flask初学者参考。

一、Flask蓝图目录

在之前的Flask项目实践中，我们通常自行设计目录结构。实际上，Flask官方提供了一套推荐的目录组织方式。以下展示了一个符合官方规范的小型Flask应用项目结构示例：

如图所示，这是构建完成后的目录层级。我们逐层分析：首先是app目录，它作为主应用程序的核心目录，内部包含一个__init__.py文件，其具体代码如下：

app/__init__.py


from flask import Flask
from .views.acc import acc_bp
from .views.user import user_bp

def create_app():
    my_app = Flask(__name__)
    my_app.register_blueprint(acc_bp)
    my_app.register_blueprint(user_bp)

    return my_app

app/__init__.py

__init__.py函数用于构建应用实例，并将views目录下的蓝图（Blueprint）注册到应用中。

接下来是static目录，顾名思义，该目录用于存放静态资源文件。

随后是templates目录，用于存放HTML模板文件。

最后是views目录，这是核心部分，存放视图函数文件，即我们提到的Blueprint。每个文件对应一个Blueprint，具体示例如下： views/acc.py


from flask import Blueprint

acc_bp = Blueprint('acc', __name__)

@acc_bp.route("/acc")
def accfunc():
    return "my_app.acc"

views/acc.py

views/user.py


from flask import Blueprint

user_bp = Blueprint('user', __name__)

@user_bp.route("/login")
def user_login():
    return "my_app.user"

views/user.py

接下来是关键文件manager.py，它是项目的启动入口，代码内容如下：

manager.py


from app import create_app

my_app = create_app()

if __name__ == '__main__':
    my_app.run()

manager.py

二、Flask-SQLAlchemy

1、安装


pip install Flask-SQLAlchemy

2、基于上述Flask项目，引入Flask-SQLAlchemy以增强项目的数据交互能力。

2.1 集成Flask-SQLAlchemy组件

app/__init__.py


from flask import Flask
from flask_sqlalchemy import SQLAlchemy    # 导入Flask-SQLAlchemy中的SQLAlchemy

db = SQLAlchemy()   # 实例化SQLAlchemy
# 注意：实例化SQLAlchemy的代码必须要在引入蓝图之前

# 引入蓝图
from .views.acc import acc_bp
from .views.user import user_bp


def create_app():
    my_app = Flask(__name__)

    # 初始化app配置，专门针对SQLAlchemy 进行配置
    my_app.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://root:@127.0.0.1:3306/wll?charset=utf8"
    my_app.config["SQLALCHEMY_POOL_SIZE"] = 5    # SQLAlchemy的连接池大小
    my_app.config["SQLALCHEMY_POOL_TIMEOUT"] = 15   # SQLAlchemy的连接超时时间
    my_app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False

    db.init_app(my_app)  # 初始化SQLAlchemy , 本质就是将以上的配置读取出来

    my_app.register_blueprint(acc_bp)
    my_app.register_blueprint(user_bp)

    return my_app

app/__init__.py

2.2 在app目录下创建models.py文件，用于定义ORM模型。

app/models.py


from app import db

# from sqlalchemy.ext.declarative import declarative_base
# Base = declarative_base()
# 之前我们在创建数据表的时候都要做这样一件事，然而Flask-SQLAlchemy已经为我们把 Base 封装好了，即db.Model

# 建立users数据表
class Users(db.Model):
    __tablename__ = 'users'
    # __table_args__ = {"useexisting": True}

    # Flask-SQLAlchemy 也为我们封装好了Column，Integer，String等
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(32))
    password = db.Column(db.String(32))


if __name__ == '__main__':
    from app import create_app
    my_app = create_app()
    # 这里你要回顾一下Flask应用上下文管理了
    # 离线脚本:
    with my_app.app_context():
        db.drop_all()        # 删除所有表
        db.create_all()      # 创建表

app/models.py

2.3 登录视图函数实现

回顾之前使用SQLAlchemy时，需要手动打开会话（db_session）。


 from sqlalchemy.orm import sessionmaker
   Session = sessionmaker(engine)
   db_session = Session()

现在无需手动操作，因为Flask-SQLAlchemy已自动处理会话的开启与管理。


from flask import Blueprint, request, render_template

user_bp = Blueprint('user', __name__)

from app.models import Users
from app import db


@user_bp.route("/login", methods=['GET', 'POST'])
def user_login():
    if request.method == 'POST':
        username = request.form.get('username')
        password = request.form.get('password')

        # 还记不记得我们在sqlalchemy中手动打开会话 db_session
        # from sqlalchemy.orm import sessionmaker
        # Session = sessionmaker(engine)
        # db_session = Session()
        # 现在不用了,因为 Flask-SQLAlchemy 也已经为我们做好会话打开的工作
        db.session.add(Users(name=username,password=password))
        db.session.commit()

        # 查询
        user_obj = Users.query.filter(Users.name == username and Users.password == password).first()
        if user_obj:
            return f"{user_obj.name}登录成功"

    return render_template("login.html")

views/user.py

2.4 登录页面模板


<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
<form method="post" action="">
  <input type="text" name="username">
  <input type="password" name="password">
  <input type="submit">
</form>
</body>
</html>

templates/login.html

三、Flask-Script

1、安装


pip install Flask-Script

2、在上述项目基础上，引入Flask-Script以支持通过命令行启动项目。

这部分内容主要为后续使用Flask-Migrate做准备。Flask-Script意为Flask的脚本扩展。你是否熟悉Django的启动命令？没错，即python manager.py runserver。借助Flask-Script，Flask也能实现类似功能。

3.1 将Flask-Script集成到项目中


from flask_script import Manager    # 导入Flask-Script中的Manager

from app import create_app

my_app = create_app()

manager = Manager(my_app)    # 让app支持manager

if __name__ == '__main__':
    # my_app.run()
    manager.run()   # 替换原来的 my_app.run() 就可以了

manager.py

3.2 使用命令行启动Flask项目


python manager.py runserver

3.3 启动项目并修改配置参数（监听IP地址与端口号）


python manager.py runserver -h 0.0.0.0 -p 9527

3.4 高级操作 - 自定义脚本命令

方法一：使用@manager.command装饰器


from flask_script import Manager    # 导入Flask-Script中的Manager

from app import create_app

my_app = create_app()

manager = Manager(my_app)    # 让app支持manager

@manager.command
def runflask(arg):
    # my_app.run()   # 释放此句项目humg住
    print(arg)


if __name__ == '__main__':
    # my_app.run()
    manager.run()   # 替换原来的 my_app.run() 就可以了

manager.py

执行命令示例：


python manager.py runflask 22

运行结果如下图所示：

执行命令示例：


python manager.py talk -n 你 -s 厉害
python manager.py talk --name 我 --say 厉害

四、Flask-Migrate

1、安装


pip install Flask-Migrate

2、继续基于前述项目，使Flask支持makemigration和migrate命令。

4.1 将Flask-Migrate（注意：该组件依赖Flask-Script）集成到项目中


from flask_script import Manager    # 导入Flask-Script中的Manager
# 导入 Flask-Migrate 中的 Migrate 和 MigrateCommand
# 这两个东西说白了就是想在 Flask-Script 中添加几个命令和指令而已
from flask_migrate import Migrate, MigrateCommand

from app import create_app

my_app = create_app()

manager = Manager(my_app)    # 让app支持manager

from app import db
Migrate(my_app, db)  # 既然是数据库迁移,那么就得告诉他数据库在哪里,并且告诉他要支持哪个app
# 接下来再告诉manager 有新的指令了,这个新指令在MigrateCommand 中存着呢
manager.add_command("database", MigrateCommand)  # 当你的命令中出现 database 指令,则去MigrateCommand中寻找对应关系
"""
数据库迁移指令:
python manager.py database init 
python manager.py database migrate     # 相当于Django中的 makemigration
python manager.py database upgrade     # 相当于Django中的 migrate
"""


@manager.command
def runflask(arg):
    # my_app.run()   # 释放此句项目humg住
    print(arg)


@manager.option("-n", "--name", dest="name")
@manager.option("-s", "--say", dest="say")
def talk(name, say):
    print(f"{name}可真{say}")


if __name__ == '__main__':
    # my_app.run()
    manager.run()   # 替换原来的 my_app.run() 就可以了

manager.py

4.2 执行数据库初始化指令


python manager.py database init

此时，项目目录中会出现一个migrations目录，结构如下：

4.3 执行数据库迁移指令


python manager.py database migrate     # 相当于Django中的 makemigration
python manager.py database upgrade     # 相当于Django中的 migrate

运行结果如下图所示：

此时，数据库中会生成一个users表。

至此，关于Python框架Flask的知识总结介绍完毕。如需了解更多Python Flask相关内容，请查阅本站往期文章或继续浏览后续内容，感谢大家的支持！

相关标签: Python Flask SQLAlchemy 数据库

免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。

作者最新文章

全部文章

JavaScript 实现数组变化监测的原理与代码实现2026-10-16
PHP Memcache 缓存基础用法与数据库查询优化2026-10-16
C# 泛型核心机制与最佳实践详解2026-10-16
SQL Server中INSERT INTO SELECT与SELECT INTO的使用及差异2026-10-16
JavaScript使用Canvas实现移动端与PC端通用签字功能2026-10-16

Python 相关产品和应用

全部下载

Python Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

Python 机器学习

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Python 代码质量

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Python 代码质量

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

Python pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

Python FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架，支持类型提示和自动接口文档。

Python Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Python Django

Django

6.1.2 · Windows

成熟的 Python Web 框架，适合构建内容站点和业务系统。

Python Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

Python SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。

Flask框架核心组件与项目结构实战指南

一、Flask蓝图目录

二、Flask-SQLAlchemy

2.1 集成Flask-SQLAlchemy组件

2.2 在app目录下创建models.py文件，用于定义ORM模型。

2.3 登录视图函数实现

2.4 登录页面模板

三、Flask-Script

3.1 将Flask-Script集成到项目中

3.2 使用命令行启动Flask项目

3.3 启动项目并修改配置参数（监听IP地址与端口号）

3.4 高级操作 - 自定义脚本命令

四、Flask-Migrate

4.1 将Flask-Migrate（注意：该组件依赖Flask-Script）集成到项目中

4.2 执行数据库初始化指令

4.3 执行数据库迁移指令

相关文章

作者最新文章

Python 相关产品和应用

Selenium

scikit-learn

Black

Ruff

pytest

FastAPI

Flask

Django

Spyder

SciPy