一、模型基础

1.1 什么是 Django 模型

Django 模型是与数据库交互的核心组件，每个模型类对应数据库中的一张表。通过模型，开发者可以使用 Python 代码定义数据结构，而无需编写 SQL 语句。

from django.db import models

class Article(models.Model):
    """文章模型"""
    title = models.CharField('标题', max_length=200)
    content = models.TextField('内容')
    created_at = models.DateTimeField('创建时间', auto_now_add=True)

    class Meta:
        verbose_name = '文章'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.title

第一章：数据库基础配置

SQLAlchemy 简介

SQLAlchemy 是 Python 中最流行的 ORM（对象关系映射）库，FastAPI 官方推荐使用 SQLAlchemy 进行数据库操作。SQLAlchemy 2.0 版本引入了更好的异步支持和类型提示。

安装依赖

# 核心依赖
pip install sqlalchemy

# 异步支持
pip install sqlalchemy[asyncio]

# 数据库驱动
pip install asyncpg          # PostgreSQL 异步驱动
pip install aiomysql         # MySQL 异步驱动
pip install aiosqlite        # SQLite 异步驱动

# 数据库迁移
pip install alembic

第一章：Flask-SQLAlchemy 入门

什么是 SQLAlchemy？

SQLAlchemy 是 Python 中最流行的 ORM（对象关系映射）库。Flask-SQLAlchemy 是 SQLAlchemy 的 Flask 扩展，简化了配置和使用。

安装与配置

pip install flask-sqlalchemy
# 可选：安装数据库驱动
pip install pymysql        # MySQL
pip install psycopg2-binary  # PostgreSQL