跳至主要內容

ASP.NET Core 第一步從第一個 API 到上線

寫給有程式設計經驗、但沒碰過 C# 的你。基於 .NET 10 與 Minimal API,一步只學一個概念,每一章都是能直接 dotnet run 的完整專案。

三十秒預覽

一個完整的 Web API,只有 17 行 ​

這就是第 02 章結束時你會寫出的程式:一個回傳 JSON 的 API,外加自動產生的互動式 API 文件。沒有設定檔案要改,沒有樣板類別要繼承。

  1. 建立專案一條 dotnet new web 指令得到一個最小的 Web 專案
  2. 宣告端點MapGet 把 URL 和一個普通函式連起來,回傳值自動序列化為 JSON
  3. 執行dotnet watch 啟動服務,改程式碼後自動熱重新載入
  4. 開啟文件存取 /scalar,在瀏覽器裡直接除錯你的 API
Program.cs
cs
using 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 要用到相依性注入,身分驗證要用到中介軟體。所以教學是一條線性主線,建議按順序閱讀。

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

  1. 入門

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

  2. 應用程式骨架

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

  3. 資料存取

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

  4. 安全

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

  5. 上線

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

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