学习路线
这套教程是一条线性的主线,不是一本可以随意翻阅的参考手册。每一章都建立在前面章节的基础上:
- 「请求与响应」里学到的参数绑定,是后面所有接口的基础;
- 「数据访问」要用到「应用骨架」里的依赖注入和配置;
- 「安全」中的认证与授权,本质上是在中间件管道里插入的环节。
所以请按顺序阅读。每一章对应仓库 samples/ 目录下一个独立、完整、可运行的项目,你随时可以打开对应的示例和自己的代码对照。
请求与响应
从 HTTP 请求里取数据,再把结果正确地返回
应用骨架
让应用可配置、可观测,组件之间松耦合
数据访问
用 EF Core 把数据存进 SQLite,组合成完整的 API
每一页怎么读
每一页都遵循相同的结构,熟悉之后你会读得很快:
- 完整代码:页面开头就给出本节最终的完整程序,可以先复制运行,看看效果;
- 运行与验证:给出运行命令和预期输出,确认你的环境和结果都没问题;
- 逐段拆解:高亮本节新增或变化的行,逐一解释它做了什么、为什么这样设计;
- 总结:用几条要点回顾本节内容,并链接到下一页。
页面中会出现四种提示框,含义是固定的:
提示
实用技巧,能让你少走弯路。
技术细节
底层原理。第一次阅读时可以跳过,不影响后续内容。
注意
常见的坑,建议一定要读。
FastAPI 对照
如果你写过 FastAPI,这里会用一两句话告诉你对应的概念是什么。没写过也没关系,直接跳过即可。
