### Flask SQLAlchemy 集成与使用教程 Flask-SQLAlchemy 是 Flask 框架的一个扩展，用于简化在 Flask 应用中使用 SQLAlchemy 的过程[^1]。以下是关于如何集成和使用的详细说明以及示例。 #### 环境搭建 为了使用 Flask-SQLAlchemy，首先需要安装必要的依赖项： ```bash pip install flask-sqlalchemy ``` 如果计划连接 MySQL 数据库，则还需要额外安装 `MySQLdb` 或其替代品： ```bash pip install pymysql ``` #### 基本配置 在 Flask 中集成 SQLAlchemy 通常涉及以下几个步骤： 1. **创建 Flask 应用实例** 2. **配置数据库 URI** 3. **初始化 SQLAlchemy** 下面是一个完整的配置示例： ```python from flask import Flask from flask_sqlalchemy import SQLAlchemy app = Flask(__name__) # 设置密钥和其他必要参数 app.config['SECRET_KEY'] = 'your_secret_key' # 配置 SQLite 数据库 (可以替换为其他类型的数据库) app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False # 关闭修改跟踪以节省内存 # 初始化 SQLAlchemy 扩展 db = SQLAlchemy(app) @app.route('/') def index(): return "Database Integration Example" ``` 此处设置了 SQLite 数据库作为默认存储方案[^2]。可以通过更改 `SQLALCHEMY_DATABASE_URI` 来切换到不同的数据库后端，例如 PostgreSQL 或 MySQL。 #### 创建模型 Flask-SQLAlchemy 提供了一种简单的方式来定义数据模型并将其映射到数据库表结构。以下是如何定义一个基本的用户模型的例子： ```python class User(db.Model): id = db.Column(db.Integer, primary_key=True) username = db.Column(db.String(80), unique=True, nullable=False) email = db.Column(db.String(120), unique=True, nullable=False) def __repr__(self): return f"<User {self.username}>" ``` 此代码片段展示了如何利用 SQLAlchemy ORM 将 Python 类转化为数据库表[^3]。 #### 插入、更新和删除操作 所有的 CRUD 操作都需要通过 `db.session` 进行管理。具体如下所示： ##### 添加新记录 ```python new_user = User(username='john_doe', email='john@example.com') db.session.add(new_user) db.session.commit() ``` ##### 更新现有记录 ```python user = User.query.filter_by(username='john_doe').first() if user: user.email = 'new_email@example.com' db.session.commit() ``` ##### 删除记录 ```python user_to_delete = User.query.get(1) # 获取 ID 为 1 的用户 if user_to_delete: db.session.delete(user_to_delete) db.session.commit() ``` 这些操作均需调用 `commit()` 方法才能生效[^4]。 #### 查询数据 查询功能非常灵活，支持多种方式检索数据： ```python all_users = User.query.all() # 返回所有用户列表 specific_user = User.query.filter_by(username='john_doe').first() # 查找特定用户名的第一个匹配项 count_of_users = User.query.count() # 统计总共有多少条记录 ``` 以上方法能够满足大多数常见的查询需求[^5]。 ---