教程

学习导向。 教程是带你第一次成功的手把手课程。你可能完全不熟悉这个库，也不需要完全理解每一行代码——只要照着做，每一步都能看到预期的结果。 看完三篇教程，你会拥有一个跑起来的项目，并且对 sqlmodel-ext 的核心能力有完整的肌肉记忆。

学习路径

教程有顺序，建议按编号依次完成。每篇教程都建立在前一篇的基础上。

顺序	教程	时长	你将获得
1	快速上手	15 分钟	装好库、跑通第一个 CRUD、理解"模型 + Mixin = 表"的基本范式
2	构建博客 API	60 分钟	一个完整的 FastAPI 后端：用户、文章、评论、分页、JOIN、关系预加载
3	给博客加 Redis 缓存	30 分钟	在上一篇的项目上接入 CachedTableBaseMixin，验证缓存命中与失效

教程不是什么

教程不会穷尽所有 API。如果你需要的功能在教程里没出现，那是正常的——

• 想找某个方法的完整参数？去 参考。
• 想完成一个具体任务（例如"如何处理并发更新"）？去 操作指南。
• 想理解某个机制为什么这么设计？去 讲解。

准备工作

所有教程假设你具备：

• Python 3.10+
• 基本的 async / await 语法
• 知道 SQL 的 SELECT / INSERT / UPDATE / DELETE 是什么

不需要事先了解 SQLAlchemy、SQLModel 或 ORM——教程会按需引入这些概念。