跳到正文

学习路线 ​

这套教程是一条线性的主线,不是一本可以随意翻阅的参考手册。每一章都建立在前面章节的基础上:

  • 「请求与响应」里学到的参数绑定,是后面所有接口的基础;
  • 「数据访问」要用到「应用骨架」里的依赖注入和配置;
  • 「安全」中的认证与授权,本质上是在中间件管道里插入的环节。

所以请按顺序阅读。每一章对应仓库 samples/ 目录下一个独立、完整、可运行的项目,你随时可以打开对应的示例和自己的代码对照。

共 6 个阶段、24 章,已完成 24 章。

  1. 入门

    装好工具,认识 C#,跑起第一个接口

  2. 应用骨架

    让应用可配置、可观测,组件之间松耦合

  3. 数据访问

    用 EF Core 把数据存进 SQLite,组合成完整的 API

  4. 安全

    先确认"你是谁",再决定"你能做什么"

  5. 上线

    测试、整理代码结构,然后发布出去

每一页怎么读 ​

每一页都遵循相同的结构,熟悉之后你会读得很快:

  1. 完整代码:页面开头就给出本节最终的完整程序,可以先复制运行,看看效果;
  2. 运行与验证:给出运行命令和预期输出,确认你的环境和结果都没问题;
  3. 逐段拆解:高亮本节新增或变化的行,逐一解释它做了什么、为什么这样设计;
  4. 总结:用几条要点回顾本节内容,并链接到下一页。

页面中会出现四种提示框,含义是固定的:

提示

实用技巧,能让你少走弯路。

技术细节

底层原理。第一次阅读时可以跳过,不影响后续内容。

注意

常见的坑,建议一定要读。

FastAPI 对照

如果你写过 FastAPI,这里会用一两句话告诉你对应的概念是什么。没写过也没关系,直接跳过即可。

基于 .NET 10 与 Minimal API · 所有示例均可直接 dotnet run