跳至主要內容

學習路線 ​

這套教學是一條線性的主線,不是一本可以隨意翻閱的參考手冊。每一章都建立在前面章節的基礎上:

  • 「請求與回應」裡學到的參數繫結,是後面所有 API 的基礎;
  • 「資料存取」要用到「應用程式骨架」裡的相依性注入和設定;
  • 「安全」中的身分驗證與授權,本質上是在中介軟體管道裡插入的環節。

所以請按順序閱讀。每一章對應儲存庫 samples/ 目錄下一個獨立、完整、可執行的專案,你隨時可以開啟對應的範例和自己的程式碼對照。

共 6 個階段、24 章,已完成 24 章。

  1. 入門

    裝好工具,認識 C#,執行第一個 API

  2. 應用程式骨架

    讓應用程式可設定、可觀測,元件之間維持低耦合

  3. 資料存取

    用 EF Core 將資料存進 SQLite,組合成完整的 API

  4. 安全

    先確認「你是誰」,再決定「你能做什麼」

  5. 上線

    測試、整理程式碼結構,然後發佈

每一頁怎麼讀 ​

每一頁都遵循相同的結構,熟悉之後你會讀得很快:

  1. 完整程式碼:頁面開頭就給出本節最終的完整程式,可以先複製執行,看看效果;
  2. 執行與驗證:給出執行指令和預期輸出,確認你的環境和結果都沒問題;
  3. 逐段拆解:高亮本節新增或變化的行,逐一解釋它做了什麼、為什麼這樣設計;
  4. 總結:用幾條要點回顧本節內容,並連結到下一頁。

頁面中會出現四種提示框,含義是固定的:

提示

實用技巧,能讓你少走彎路。

技術細節

底層原理。第一次閱讀時可以跳過,不影響後續內容。

注意

常見的坑,建議一定要讀。

FastAPI 對照

如果你寫過 FastAPI,這裡會用一兩句話告訴你對應的概念是什麼。沒寫過也沒關聯,直接跳過即可。

採用 .NET 10 與 Minimal API · 所有範例皆可直接 dotnet run