學習路線
這套教學是一條線性的主線,不是一本可以隨意翻閱的參考手冊。每一章都建立在前面章節的基礎上:
- 「請求與回應」裡學到的參數繫結,是後面所有 API 的基礎;
- 「資料存取」要用到「應用程式骨架」裡的相依性注入和設定;
- 「安全」中的身分驗證與授權,本質上是在中介軟體管道裡插入的環節。
所以請按順序閱讀。每一章對應儲存庫 samples/ 目錄下一個獨立、完整、可執行的專案,你隨時可以開啟對應的範例和自己的程式碼對照。
請求與回應
從 HTTP 請求中取得資料,再正確地回傳結果
應用程式骨架
讓應用程式可設定、可觀測,元件之間維持低耦合
資料存取
用 EF Core 將資料存進 SQLite,組合成完整的 API
安全
先確認「你是誰」,再決定「你能做什麼」
每一頁怎麼讀
每一頁都遵循相同的結構,熟悉之後你會讀得很快:
- 完整程式碼:頁面開頭就給出本節最終的完整程式,可以先複製執行,看看效果;
- 執行與驗證:給出執行指令和預期輸出,確認你的環境和結果都沒問題;
- 逐段拆解:高亮本節新增或變化的行,逐一解釋它做了什麼、為什麼這樣設計;
- 總結:用幾條要點回顧本節內容,並連結到下一頁。
頁面中會出現四種提示框,含義是固定的:
提示
實用技巧,能讓你少走彎路。
技術細節
底層原理。第一次閱讀時可以跳過,不影響後續內容。
注意
常見的坑,建議一定要讀。
FastAPI 對照
如果你寫過 FastAPI,這裡會用一兩句話告訴你對應的概念是什麼。沒寫過也沒關聯,直接跳過即可。
