【範例】Hello World / 為什麼開始寫部落格

Wed, 21 Oct 2026 00:00:00 GMT

注意： 這是示範用的範例文章，方便預覽版型與排版，之後可以刪除或改寫。

2018 年時我曾在 GitHub Pages 上放過幾篇前端框架筆記，後來忙於工作就停更了。現在重新用 Astro 架站，希望把可重複查閱的技術筆記與實驗心得整理在同一個地方。

我想記錄什麼

後端與 API 設計（C# / ASP.NET、Java）
前端與全端整合（Angular 等）
AI 輔助開發的流程、工具與取捨
偶爾的學習雜記與除錯過程

給自己的提醒

短文也沒關係，重點是留下脈絡。
程式碼範例要可讀，將來的自己也會感謝現在的自己。
中英文混用可以，但標題與摘要盡量寫清楚。

若你也是很久沒更新個人網站的人，歡迎從一篇「為什麼開始」寫起——這篇就是這樣誕生的。

【範例】C# async/await：避免常見的 fire-and-forget 陷阱

Tue, 20 Oct 2026 00:00:00 GMT

注意： 以下內容為教學範例，非 production 完整實作。

在 ASP.NET 或背景工作中，async/await 幾乎是日常。最常見的問題不是語法，而是沒有 await 就放行 Task，導致例外被吞掉或請求提早結束。

正確：await 完成再繼續

public async Task<User?> GetUserAsync(int id, CancellationToken cancellationToken)
{
    var response = await _httpClient.GetAsync($"/api/users/{id}", cancellationToken);
    response.EnsureSuccessStatusCode();

    return await response.Content.ReadFromJsonAsync<User>(cancellationToken: cancellationToken);
}

await 會在 I/O 完成前讓出執行緒，但不會阻塞執行緒池——這正是 async 在伺服器端的價值。

陷阱：fire-and-forget

// ❌ 不要這樣做：例外可能變成 UnobservedTaskException
_ = SendAuditLogAsync(userId);

public async Task SendAuditLogAsync(int userId)
{
    await _queue.PublishAsync(new AuditEvent(userId));
}

若 audit 失敗你應該知道。較安全的做法包括：

在 HTTP 請求路徑上 await 關鍵工作；
或使用 BackgroundService / 訊息佇列，並在邊界記錄失敗；
若真的必須 detach，使用明確的錯誤處理（例如 Task.Run 包裝並 log），而不是裸 _ = task。

小結

async/await 讓非同步程式碼讀起來像同步，但Task 的生命週期仍然要管理。寫 API 時，問自己一句：「如果這個 Task 失敗，誰負責記錄與重試？」

這篇範例主要展示程式碼區塊在淺色 / 深色模式下的 Shiki 高亮效果。正式文章請刪除【範例】標記並替換成你的內容。