SQLAlchemy 是 Python 中流行的 ORM 工具，1. 通过安装 sqlalchemy 及数据库驱动并配置 engine 和 session 可实现数据库连接；2. 使用类定义数据模型并映射为数据库表，如 User 模型对应 users 表；3. 在 FastAPI 等框架中通过依赖注入管理会话，实现接口路由与数据库交互；4. 支持 query 方式进行增删改查操作，简化 CRUD 开发。
SQLAlchemy 是 Python 中最流行的 ORM（对象关系映射）工具之一，它能让开发者用面向对象的方式操作数据库，而无需直接写原始 SQL。在 Python 网页开发中，无论是使用 Flask、FastAPI 还是 Django（通过第三方扩展），SQLAlchemy 都能很好地集成进来，简化数据层的管理。
1. 安装与基本配置
在开始之前，先安装 SQLAlchemy 和数据库驱动。以 SQLite 为例（适合初学者），你可以这样安装：
pip install sqlalchemy如果使用 MySQL 或 PostgreSQL，还需要额外安装对应驱动，例如：
pip install pymysql # MySQLpip install psycopg2 # PostgreSQL
接下来创建一个基础的数据库连接配置：
立即学习“Python免费学习笔记（深入）”；
from sqlalchemy import create_enginefrom sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker
数据库地址，这里以 SQLite 为例
DATABASE_URL = "sqlite:///./test.db"
engine = create_engine(DATABASE_URL)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
Base = declarative_base()
这个配置会创建一个本地 SQLite 数据库文件 test.db，并准备好用于后续操作的会话类。
2. 定义数据模型
在网页应用中，通常需要将用户、文章、订单等实体映射为数据库表。SQLAlchemy 允许你用类来定义这些结构。
例如，定义一个用户模型：
from sqlalchemy import Column, Integer, Stringclass User(Base):
tablename = "users"
id = Column(Integer, primary_key=True, index=True)
name = Column(String(50), index=True)
email = Column(String(100), unique=True, index=True)
然后创建表：
Base.metadata.create_all(bind=engine)
这会在数据库中生成 users 表，字段对应类中的列定义。
3. 在网页框架中集成（以 FastAPI 为例）
FastAPI 是现代 Python Web 框架，非常适合与 SQLAlchemy 结合使用。
你需要在请求处理前获取数据库会话，在结束后关闭它。可以使用依赖注入实现：
from fastapi import Depends, FastAPI, HTTPExceptionapp = FastAPI()
def get_db():
db = SessionLocal()
try:
yield db
finally:
db.close()
@app.post("/users/")
def create_user(name: str, email: str, db: Session = Depends(get_db)):
db_user = User(name=name, email=email)
db.add(db_user)
db.commit()
db.refresh(db_user)
return db_user
上面代码注册了一个接口，接收 name 和 email 参数，插入新用户并返回结果。
4. 查询与操作数据
SQLAlchemy 提供了丰富的查询接口，比如：
# 查询所有用户db.query(User).all()
按条件查询
db.query(User).filter(User.name == "Alice").first()
更新数据
user = db.query(User).filter(User.id == 1).first()
user.name = "New Name"
db.commit()
删除数据
db.query(User).filter(User.id == 1).delete()
db.commit()
这些操作在网页后端非常常见，结合路由逻辑即可完成完整的 CRUD 功能。
基本上就这些。SQLAlchemy 让你在 Python 网页项目中更专注业务逻辑，而不是拼接 SQL 字符串。只要掌握模型定义、会话管理和基本查询语法，就能高效开发数据驱动的网站。
