一頁只學一個概念
每一頁開頭先給出最終的完整程式碼,再逐段拆解,並用行高亮標出本節新增的部分。不會一次塞給你十個新名詞。
寫給有程式設計經驗、但沒碰過 C# 的你。基於 .NET 10 與 Minimal API,一步只學一個概念,每一章都是能直接 dotnet run 的完整專案。
三十秒預覽
這就是第 02 章結束時你會寫出的程式:一個回傳 JSON 的 API,外加自動產生的互動式 API 文件。沒有設定檔案要改,沒有樣板類別要繼承。
dotnet new web 指令得到一個最小的 Web 專案MapGet 把 URL 和一個普通函式連起來,回傳值自動序列化為 JSONdotnet watch 啟動服務,改程式碼後自動熱重新載入/scalar,在瀏覽器裡直接除錯你的 APIusing Scalar.AspNetCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddOpenApi();
var app = builder.Build();
if (app.Environment.IsDevelopment())
{
app.MapOpenApi();
app.MapScalarApiReference();
}
app.MapGet("/", () => new { Message = "Hello, ASP.NET Core!" });
app.Run();學習路線
後面的章節依賴前面的內容:EF Core 要用到相依性注入,身分驗證要用到中介軟體。所以教學是一條線性主線,建議按順序閱讀。
從 HTTP 請求中取得資料,再正確地回傳結果
讓應用程式可設定、可觀測,元件之間維持低耦合
用 EF Core 將資料存進 SQLite,組合成完整的 API
先確認「你是誰」,再決定「你能做什麼」