Huan-Lin 學習筆記

本頁 50 篇

• 新書上架：《C# 不可變資料設計》

  • #.NET
  • #寫作與出版

  新書上架 5 折優惠：《C# 不可變資料設計》 (beta)我的新書《C# 不可變資料設計》在「一步出版」上架了。10/10～10/11 這兩天有雙十國慶和新書上架的 5 折優惠。完成度：目前是 beta 版全書共 6 章，正在進行人工校對和細部調整。Note: 2026 年 10 月 10 日之前有在「一步出版」站內購買、或透過贈書活動取得任何一本 .NET 書籍的會員，系統已自動贈送《C# 不可變資料設計》，無須另行購買。（答謝很早就加入 "一步出版" 的 early bird 會員，以及持續購書的支持 🙏） 以下是〈作者序〉，也可以到出版社網站的線上試讀版閱讀更多。作者序以當前 LLM（Large Language Model）的能力，開發人員可能只要對 AI agent 說：「幫我把這個專案的某些類別重構成 immutable types。」AI 就能完成重構，連相關的測試也一併寫好。然而，開發者如何能確定專案中的哪些部分應該要採用不可變設計（immutable design）？預期能帶來哪些好處？如何驗證其效益？以及，如何判斷 AI 採取的作法是恰當的？我認為，無論與 AI

  2026/10/10 08:54Michael Tsaihttps://www.huanlintalk.com/2026/10/new-book-csharp-immutable-data-design.html

  

• Ippo Books 線上書店限時五折優惠

  • #寫作與出版

  「一步出版」的線上書店（站內購買）開張，限時全站五折。限時全站 5 折活動期間為 2026 年 9 月 25 日 00:00 至 9 月 27 日 23:59（台灣時間）。活動期間，Ippo Books 站內目前上架販售的電子書均享 5 折優惠。優惠僅適用於透過 Ippo Books 直接購買的訂單，其他電子書平台的售價與活動不在此範圍內。付款完成後，書籍會自動加入書櫃，即可開始線上閱讀，或者下載 EPUB 。如下圖：其他平台既有讀者免費開通如果你曾在其他電子書平台付費購買 Ippo Books 目前上架的同一本書，可以申請將該書免費加入 Ippo Books 個人書櫃，不必再次購買。申請期限至 2026 年 9 月 27 日 23:59（台灣時間）。原則上只能申請購買憑證所對應的同一本書。不過，如果你曾付費購買第一版《現代 C#：AI 時代的開發者修煉》，也可以申請開通第二版《現代 C# 精要（第二版）》。詳情可參閱官網公告：Ippo Books 線上書店開站 5 折與讀者贈書活動

  2026/9/25 19:27Michael Tsaihttps://www.huanlintalk.com/2026/09/ippo-books-limited-time-offer.html

  

• C# 15 - 封閉階層（closed hierachies）

  • #C++
  • #.NET

  介紹 C# 15 的新功能：封閉階層（closed hierachies）。假設你正在設計一套訂單 API，並以 OrderState 表示訂單狀態。程式庫裡目前有等待付款、已付款、已出貨和已取消四種狀態，像這樣：public abstract record class OrderState; public record class Pending : OrderState; public record class Paid(DateTime PaidAt) : OrderState; public record class Shipped(string TrackingNumber) : OrderState; public record class Cancelled(string Reason) : OrderState;以後有需要時，你也想在程式庫內加入「已退款」（Refunded）狀態。但你不希望使用這套 API 的其他專案自行發明一個「暫停處理」（Suspended）狀態，然後傳進你的程式。因為你的訂單處理流程根本不知道該拿這個新狀態怎麼辦。這個需求聽起來很合理：允許自己的

  2026/9/9 22:43Michael Tsaihttps://www.huanlintalk.com/2026/09/csharp-15-closed-hierarchies.html

  

• C# 15 - 聯合型別 (Union Types)

  • #C++
  • #.NET

  介紹 C# 15 的新功能：Union Types假設我們在設計一個付款功能時，寫了這樣的類別：public enum PaymentKind { Cash, CreditCard, BankTransfer } public class Payment { public PaymentKind Kind { get; set; } public decimal Amount { get; set; } public string? CardLast4 { get; set; } public string? TransferReference { get; set; } }Kind 區分現金、信用卡與銀行轉帳；CardLast4 記錄信用卡末四碼，TransferReference 記錄轉帳交易編號，供付款摘要使用。但這個類別也允許你建立下面這個物件：var payment = new Payment { Kind = PaymentKind.CreditCard, Amount = 1200m, CardLast4 = null, TransferReference = "TX-2

  2026/9/8 00:58Michael Tsaihttps://www.huanlintalk.com/2026/09/csharp-15-union-types.html

  

• C# 15 - 具標籤的 break 和 continue

  • #C++
  • #.NET

  C# 15 新功能：具標籤的 break 和 continue。注意：寫作本文時 .NET 11 尚未正式發布，文中的範例程式是以 .NET 11 Preview 7 SDK 編譯。在撰寫演算法或處理多維矩陣時，巢狀迴圈是極為常見的結構。然而，當我們需要在內層迴圈滿足特定條件時「直接跳出整個外層迴圈」或「跳過當前列直接前進外層下一輪」，傳統 C# 的控制流程往往顯得笨重。傳統多層迴圈的跳脫痛點假設我們在一個二維網格中搜尋特定目標，一旦找到就要立即中斷整個搜尋。在 C# 15 之前，開發者通常只有兩種選擇：第一種是引入額外的布林旗標（boolean flag）：bool found = false; for (int r = 0; r < rows; r++) { for (int c = 0; c < cols; c++) { if (grid[r, c].IsTarget) { found = true; break; // 只能跳出內層迴圈 } } if (found) break; // 外層還得再檢查一次旗標並 break }這種寫法雖然合乎結構化規範，但旗標變數污染了上下文，

  2026/9/6 22:47Michael Tsaihttps://www.huanlintalk.com/2026/09/csharp-15-labeled-break-and-continue.html

• 電子書更新並解除 DRM

  • #.NET
  • #寫作與出版

  我的兩本 .NET 電子書更新了，而且移除數位版權限制。《現代 C#》更新移除數位版權保護：Google Play 圖書、讀墨 (Readmoo)、樂天 Kobo（有的平台可能晚幾天才會生效）〈第 4 章：不可變設計〉與〈第 5 章：錯誤處理與資源管理〉現在可以在網頁版免費閱讀全文。技術審閱時發現幾處小地方用詞不夠精確，加以改善。《深入淺出 .NET 10 併發程式設計》更新移除數位版權保護：Google Play 圖書、讀墨 (Readmoo)、樂天 Kobo （有的平台可能晚幾天才會生效）〈第 5 章：執行緒同步與經典問題〉現在可以在網頁版免費閱讀全文。技術審閱時發現幾處小地方用詞不夠精確，加以改善。以上兩本書的新版本已於 2026/9/2 上傳至各電子書平台，最遲幾天後可以看到新版本（內容僅小幅修正）。版權頁會顯示更新日期為 2026-09-01 或之後的日期。把電子書匯入 Gemini Notebook最近發現 Gemini Notebook 開始支援匯入 Google Play 圖書上面的電子書：我試了一下，發現我的書櫃裡的書，沒有一本是可以選的：問了 AI，回答可能的原因是

  2026/9/2 21:32Michael Tsaihttps://www.huanlintalk.com/2026/09/ebooks-updated-and-drm-free.html

  

• 4 個實用的 VS Code Markdown 表格編輯工具

  • #生產力
  • #技術寫作

  整理我在 VS Code 中編輯 Markdown 表格時經常使用的四個擴充套件。當我推薦別人使用 Markdown 撰寫文件時，經常會被問：「你是怎麼編輯表格的？」而對方通常比較習慣使用 WYSIWYG 視覺化編輯工具。必須承認，在表格編輯方面，無論是便利性還是效率，通常還是視覺化編輯器占上風。尤其是在 Visual Studio Code 這類純文字編輯器中編寫 Markdown 表格，如果沒有輔助工具，手工編寫表格確實不方便。這篇文章整理了我在 VS Code 中編輯 Markdown 表格時經常使用的工具，包括以下四款：Excel to Markdown tableMarkdown PasteMdTableEditorMarkdown Table Editor——有提供視覺化表格編輯器！Excel to Markdown tableRepo： https://github.com/csholmq/vscode-excel-to-markdown-table用法： 按 Shift+Alt+V 可將從 Excel 複製到剪貼簿的儲存格內容轉換成 Markdown 表格。Markdo

  2026/8/26 22:12Michael Tsaihttps://www.huanlintalk.com/2026/08/4-vs-code-extensions-for-editing.html

  

• 兩本 .NET 電子書開放更多免費章節

  • #C++
  • #.NET
  • #寫作與出版

  我更新了個人網站 huanlin.cc，並且把我的兩本電子書的更多免費章節放上去。把我的個人網站 huanlin.cc 稍微整理了一番，並且將兩本電子書的更多免費章節放上去。如下圖：《The C# You Need to Know》打算作為《現代 C#》的下一版，未來新加入的章節初稿，預計也會開放部分章節供線上閱讀。目前開放線上閱讀的章節共有 5 章，見下圖：《深入淺出 .NET 10 併發程式設計》目前沒有改版計畫，這裡開放閱讀的章節共有四章：第 1 章至第 4 章。如以下截圖：先醬。Keep learning!

  2026/7/22 23:07Michael Tsaihttps://www.huanlintalk.com/2026/07/free-chapters-from-my-books.html

  

• 用 CodeGraph 節省 Token（入門筆記）

  • #ai

  整理 CodeGraph 入門筆記。前言我在使用 AI 工具時常有這樣的操作：每當增加或修改了軟體專案的某個功能或設計決策，會讓 AI agent 更新相關的開發文件，如架構文件、設計文件等（有時候 agent 會自動更新文件）。當我知道有個叫做 CodeGraph 的工具，能夠建立軟體專案的程式碼圖譜，用來回答專案的各種問題和查詢，進而節省 token，我就想立刻試試看。同時也好奇：若在專案中使用了 CodeGraph，那我原先讓 AI agent 幫我維護的開發文件，還有必要繼續更新嗎？兩者似乎有重疊之處。Fun fact：CodeGraph 在 GitHub 平台上的星星數從今年（2026）五月底開始暴漲。CodeGraph 的學習資源，首推官方文件。在這篇筆記中，主要是以 Q & A 的形式來回答我在入門上手時的一些疑問，包括：Q1: CodeGraph 對開發者有什麼用處？Q2: CodeGraph 支援哪些程式語言？Q3: CodeGraph 能夠回答什麼、不能回答什麼？Q4: CodeGraph 是如何運作的？Q5: 如何在本機安裝並開始建立軟體專案的圖譜？Q6: 其他注

  2026/7/4 16:35Michael Tsaihttps://www.huanlintalk.com/2026/07/saving-tokens-with-codegraph.html

  

• MacBook Pro 初上手：Windows 使用者必知操作

  • #生產力

  我在 Apple 官網買了人生第一台 Mac 筆電，這是我的初上手筆記。簡介我在 2026/6/17 於 Apple 官網訂購一台 MacBook Pro，約一個星期後收到商品，於 6/26 開箱。這台筆電的規格如下：太空黑色 16 吋 MacBook Pro 配備 M5 Pro 晶片18 核心 CPU、20 核心 GPU、16 核心神經網路引擎64GB 統一記憶體2TB SSD 儲存裝置標準顯示器140W USB-C 電源轉接器含 Touch ID 的背光巧控鍵盤 - 中文 (注音)三個 Thunderbolt 5 埠、MagSafe 3 埠、3.5 公釐耳機插孔、HDMI 埠、SDXC 卡插槽支援最多達三部外接顯示器備註：有網友在臉書問我是否漲價前買的，於是我去查了一下。原來，我有點幸運，收到貨之後，蘋果官方就宣布漲價。上述規格，我購入的價格是 NT$ 124,900。寫這篇筆記的時候是 2026/6/29，我去蘋果官網選購相同規格，價格變成 NT$ 152,400。在此之前，我從未用過任何 macOS 的電腦。這是我初次使用 MacBook Pro 筆電第三天所作的筆記。學習使用

  2026/6/29 15:51Michael Tsaihttps://www.huanlintalk.com/2026/06/macbook-pro-basics-for-windows-users.html

  

• C# 的集合運算式（Collection Expressions）

  • #C++
  • #.NET

  摘錄 《現代 C#：AI 時代的開發者修煉》 第 2 章有關集合運算式（Collection Expressions）的介紹。C# 12 引入了集合運算式（Collection Expressions）之後，方括弧 [] 幾乎成了處理集合的首選語法。它不只是把程式碼寫得更短，更重要的是把陣列、List、Span、ReadOnlySpan 這些常見集合的初始化方式統一起來，也讓編譯器更有空間做最佳化。例如：int[] numbers = [1, 2, 3]; List strings = ["A", "B", "C"];Span values = [1, 2, 3];先抓住一個核心觀念：右邊的 [...] 只是元素序列的寫法；真正決定結果型別的，是左邊或使用情境提供的目標型別（target type）。使用時機本節整理集合運算式的幾個常見的使用情境，包括：初始化集合時合併多個集合時傳遞參數給方法時需要空集合時寫 Span 或 ReadOnlySpan 的程式時初始化集合這是最直觀、也最常見的使用時機。過去初始化不同集合型別時，語法風

  2026/4/5 01:33Michael Tsaihttps://www.huanlintalk.com/2026/04/csharp-collection-expressions.html

  

• .NET 非同步基礎：例外處理與取消

  • #C++
  • #.NET

  連載《深入淺出 .NET 10 併發程式設計》，這是第 4 章的完整內容。在理想的世界裡，每一次網路請求都會成功，每一個檔案都能順利讀取。但在現實世界中，網路會中斷，檔案會遺失，資料庫也可能逾時。一個穩健的應用程式，必須能妥善處理這些非預期的狀況。除此之外，由於非同步操作通常不會立刻完成，如果使用者在資料下載完成前回到上一頁，或者直接關閉了應用程式，我們也必須能取消那些仍在背景進行的任務，以免白白浪費系統資源。為了處理各種不完美的情況，你會需要了解本章的兩大主題：例外處理（exception handling）與任務取消（cancellation）。本章的學習目標包括：如何使用 try-catch 語法來捕捉 await 拋出的例外。了解 AggregateException 的角色，以及 await 如何簡化它。掌握 .NET 中標準的任務取消模式：CancellationTokenSource 與 CancellationToken。學會為非同步操作實作逾時（timeout）機制。await 如何處理例外async/await 最令人讚賞的設計之一，就在於它讓非同步的例外處理寫起來

  2026/4/3 14:41Michael Tsaihttps://www.huanlintalk.com/2026/04/net-async-exception-and-cancellation.html

  

• C# struct 的防禦性複製（defensive copy）

  • #C++
  • #.NET

  這篇文章要探討的是 C# 防禦性複製。背景比爾淑（Bill Chung）私訊給我，指出《現代 C#》第 4 章有錯誤，如下圖（紅色虛線處是誤植，應刪除）：我修正之後，他接著又提供一個蠻有意思的範例，裡面展示了兩個比較微妙（tricky）的場景：readonly 欄位和函式的 in 參數。於是，我決定把比爾淑提供的範例稍微改寫之後，放進書中的第 4 章，作為補充。我從這個議題的討論當中獲益不少，特別感謝比爾淑的指正和討論，讓這本書進一步完善。以下是正文，摘自《現代 C#》第 4 章。當你在結構中混合使用 readonly 和「非 readonly」方法時，可能會觸發編譯器的防禦性複製（defensive copy）行為。這是一個重要但容易被忽略的效能問題。什麼是防禦性複製？當一個 readonly 方法呼叫非 readonly 方法時，編譯器無法確定被呼叫的方法是否會修改結構的狀態。為了保證 readonly 方法的承諾（不修改結構內容），編譯器會採取保險措施：先複製一份結構的副本（防禦性複製），然後在這個副本上呼叫非 readonly 方法。這就像是你去圖書館借閱珍本古籍（readon

  2026/3/23 22:26Michael Tsaihttps://www.huanlintalk.com/2026/03/csharp-defensive-copy.html

  

• .NET 非同步基礎：async 與 await

  • #C++
  • #.NET

  連載《深入淺出 .NET 10 併發程式設計》，這是第 3 章的完整內容。在上一章，我們學會了使用 Task.Run 來建立背景工作，並透過 Task 物件追蹤它的狀態。不過，我們也同時發現，若用 .Wait() 或 .Result 來取得結果，就會阻塞（block）當前執行緒，這等於又把我們帶回最初想解決的「卡頓」問題。那麼，有沒有一種方法可以「非同步地等待」一個 Task 完成呢？這正是 C# 提供的 async 與 await 關鍵字要解決的事。它們是 C# 編譯器提供的語法糖（syntactic sugar），能讓我們用近乎同步程式碼的寫法，實現複雜的非同步控制流程。可以說，async/await 是現代 .NET 非同步程式設計的基石。接下來，這一章會帶你更深入地走進 async/await 的世界。讀完之後，你將能夠：使用 async 與 await 來撰寫簡潔、可讀性高的非同步程式碼。理解非同步方法的控制流是如何在 await 處暫停與恢復的。運用 Task.WhenAll、Task.WhenAny 與 Task.WhenEach 來併發執行多個非同步工作。了解 Sync

  2026/3/21 18:31Michael Tsaihttps://www.huanlintalk.com/2026/03/dotnet-10-async-book-chapter-3.html

  

• .NET 非同步基礎：執行緒與工作

  • #C++
  • #.NET

  連載《深入淺出 .NET 10 併發程式設計》，這是第 2 章的完整內容。在第一章，我們透過披薩店的比喻，理解了應用程式為什麼需要同時處理多項任務，也大致看見了多執行緒和非同步程式設計如何提升效率。然而，我們也看見了這樣做的另一面：多執行緒帶來的管理複雜性，例如 context switch 的開銷和資源同步問題。接下來，我們就正式進入 .NET 的世界，看看這些概念在程式裡到底是怎麼落實的。本章的目標，是帶你理解 .NET 中實現非同步與多工的兩個核心概念：執行緒 (thread) 與 工作 (task)，並學習如何利用現代工具避開傳統執行緒管理的陷阱。許多初學者會把執行緒與工作混為一談，但若想寫出高效、穩定的非同步程式碼，先釐清它們的區別非常重要。簡單來說：執行緒 (thread) 是一個較低階的概念，你可以把它想像成執行程式碼的「工人」。工作 (task) 是一個較高階的抽象概念，代表一個需要完成的「工作」。接下來，本章會依序走過下面幾個重點：傳統方式的挑戰：回顧直接管理執行緒的複雜性與侷限。核心觀念：Task：理解 Task 如何作為高階抽象，解決傳統執行緒管理的痛點。現代起手

  2026/3/21 17:33Michael Tsaihttps://www.huanlintalk.com/2026/03/dotnet-10-async-book-chapter-2.html

  

• .NET 非同步基礎：執行緒與非同步的奧秘

  • #C++
  • #.NET

  連載《深入淺出 .NET 10 併發程式設計》，這是第 1 章的完整內容。作為起手式的第一章，我們會盡量用通俗易懂的方式來展開。無論你之前有沒有接觸過執行緒和非同步程式設計，讀完這一章，都能在腦海中先建立起一套清楚的核心概念，作為後續章節的基礎。為何程式需要同時處理多件事？你是否曾經遇過這種情況：在桌面應用程式中按下一個按鈕後，整個視窗變成一片空白，滑鼠游標一直轉圈圈，完全無法操作？或者，在瀏覽某個熱門購物網站時，網頁載入速度極慢，甚至直接顯示逾時錯誤？這些惱人的體驗，往往指向同一個核心問題：軟體沒有有效地處理「等待」。無論是等待檔案儲存、等待網路回應，或是等待資料庫查詢結果，這些等待如果處理不當，就會導致程式卡頓，使用者體驗變差。在數位時代，我們期待應用程式能提供即時回饋與流暢體驗。無論是要讓桌面應用程式的使用者介面（UI）保持靈敏，還是要讓網站伺服器同時服務成千上萬名使用者，背後都仰賴同一種能力：同時處理多項任務。若缺乏這種能力，應用程式的反應就會變得遲鈍，使用者體驗會大打折扣，伺服器也無法應付現代網路的龐大流量。為了更具體瞭解這項能力，我們先用一間披薩店當作類比。請想像我們要一起

  2026/3/21 15:32Michael Tsaihttps://www.huanlintalk.com/2026/03/dotnet-10-async-book-chapter-1.html

  

• 新書發布：《深入淺出 .NET 10 併發程式設計》

  • #C++
  • #.NET
  • #寫作與出版

  我的新書《深入淺出 .NET 10 併發程式設計》已經出版，這裡提供新舊讀者關於本書的消息。書籍介紹與大綱，可參考官網：深入淺出 .NET 10 併發程式設計本文大綱：促銷活動付費買過《.NET 非同步程式設計》的讀者如何免費獲取新版書籍大綱作者序 促銷活動我分別在 Google Play 圖書和 Kobo 平台建立了限時促銷價：在 Google Play 圖書購買：2026/03/20～2026/03/22：新台幣 199 元。2026/03/23～2026/03/31：新台幣 299 元。備註：由於 Google 平台本身會自動調整價格，故實際的交易價格可能會加減 10 元。在 Kobo 購買：2026/03/22～2026/03/31：新台幣 199 元。有買過《.NET 非同步程式設計》的人請看由於我更換了寫作和出版平台，往後只會透過「一步出版社」發行，所以這本新書不會在 Leanpub 上面發布。之前有在 Leanpub 平台買過《.NET 非同步程式設計》的朋友，這裡提供一個免費升級的方法：請用你註冊 Leanpub 會員帳號的 email 寄一封信給我（huanlin.t

  2026/3/20 23:55Michael Tsaihttps://www.huanlintalk.com/2026/03/net-10-async-book.html

  

• Something Big Is Happening. 真的嗎？

  • #ai

  Cal Newport 對全網瘋傳的文章做出的批評，我的整理和一點感想。背景日前，用 AI agents 翻譯一批篇幅不小的文件，過程很平順、迅速，而且全部是在免費方案的額度內完成。當時是用最新的模型（為了避免失焦，這裡不具體說哪個模型），我驚訝又驚喜：這新模型似乎更厲害，以後可以和另一個 AI agent 交替使用。翻譯完成後，接著用同一個工具進行校稿，出現了免費 token 用量到頂的訊息。於是，我切換至另一個 AI agent 和付費模型，接手進行譯文校稿。AI 一邊校稿，我一邊快速查看它校稿的結果。但很快就發現，昨天那個大量翻譯的成果並不完整——很多段落被略過了！我問 AI agent 何以如此，它跑了好幾個任務去分析最近的幾次 git commit 歷史，然後告訴我，凶手不是它，而是原本的譯稿（之前用另一個 AI agent 翻譯的結果）本身就已經被嚴重刪減了：回想起來，我猜可能跟我下的 prompt 沒有明確要求「完整翻譯」有關，但也可能是工具在處理長文本時的策略。總之，結果就是 AI 把部分段落當成可省略內容（摘要翻譯）。我只好讓 AI 重頭檢查一遍：原稿跟譯文一對一、系

  2026/3/8 12:28Michael Tsaihttps://www.huanlintalk.com/2026/03/something-big-is-happening-really.html

  

• .NET 11 的 Runtime Async

  • #C++
  • #.NET

  整理一下 .NET 11 Preview 1 的新功能：Runtime Async。聲明：本文提到的 .NET 11 runtime async 功能，係針對 2026 年 2 月發布的 .NET 11 預覽版 Preview 1。未來 .NET 11 正式版發布時可能還有變動。在 .NET 11 Preview 1 的發行說明 中提到了一個新功能：runtime async。有了這項功能，.NET 11 的 runtime 會把 async 方法視為一等公民，親自接管非同步方法的執行與狀態管理。這表示長久以來，C# 編譯器在背後替 async 方法添加狀態機的機制即將走入歷史。對開發人員來說，則是立刻享有效能提升的好處。至少有以下幾點：減少 IL 程式碼與提升 JIT 執行效率： C# 編譯器不會再替 async 方法產生一堆處理狀態機的 IL code，所以編譯出來的 .NET 執行檔／DLL 檔案會更小，而 JIT 的即時編譯速度也會更快、所需的記憶體更少。減少記憶體分配： 傳統上，C# 編譯器產生的狀態機結構會被裝箱（boxed）到 heap 上，而 .NET 11 由 run

  2026/3/1 22:48Michael Tsaihttps://www.huanlintalk.com/2026/03/runtime-async-in-net-11-preview-1.html

  

• Book published: Modern C# - Developer's Craft in the AI Era (C# 14 and .NET 10)

  • #C++
  • #.NET

  My new book is published: Modern C# - Developer's Craft in the AI EraWhy mastering C# still matters in the age of AIAI is a powerful tool, but for critical systems, it cannot replace human judgment and oversight. Only when developers maintain genuine ownership of their code can they effectively manage technical debt and maintenance costs over the long term.So yes, mastering programming languages and APIs matters more than ever.However, this is not an exhaustive C# reference. Instead, this book f

  2026/2/18 11:04Michael Tsaihttps://www.huanlintalk.com/2026/02/new-book-published-modern-csharp-c-14.html

  

• 我的新書《現代 C#：AI 時代的開發者修煉》發布了

  • #C++
  • #.NET
  • #寫作與出版
  • #技術寫作

  我的新書《現代 C#：AI 時代的開發者修煉》已經出版，這裡提供新舊讀者關於本書的消息。出版社網站已於昨日發布這本書的主頁以及試讀章節：第一章，我在這裡也提供一些相關消息。內容大綱：有付費買過《C# 本事》的朋友如何升級新版內容作者序有買《C# 本事》的人請看之前有在以下平台買過《C# 本事》的朋友，應該能自動看到新版書籍的內容：Google Play 圖書Readmoo 讀墨KoboPubu我已經把《現代 C#：AI 時代的開發者修煉》這本書的內容上傳到上述平台的《C# 本事》，取代了原本的電子書內容。為了區別，封面圖片照舊，但右上角有一個「C# 14」緞帶文字可以識別你看到的是否為新版內容，如下圖：但請注意，這是一次性的更新，也就是最後一次免費更新了。往後若有錯字修正、增添內容，都只會更新《現代 C#：AI 時代的開發者修煉》。註：如果你曾經在某些電子書閱讀器上面閱讀《C# 本事》，有可能會因為檔案已經 cache 在你的閱讀裝置上，而看不到新版內容。此時建議用電腦瀏覽器登入你的電子書平台帳號，然後打開這本書，以確認內容是否為新版。Leanpub 讀者至於在 Leanpub 購買《

  2026/2/13 12:30Michael Tsaihttps://www.huanlintalk.com/2026/02/modern-csharp-book-published.html

  

• 搞懂 C# 的 ref struct

  • #C++
  • #.NET

  整理 C# 的 ref struct 的用法和相關細節。（沒有在守護堆疊啦，是被鎖在堆疊 😆）C# 7.2 引入了 ref struct，這是一種特殊的結構，只能存在於堆疊上，不能存在於堆積中。大多數情況下，你不會需要定義自己的 ref struct 型別，但了解這個概念有助於理解 .NET 的高效能 API，例如 Span 和 ReadOnlySpan。底下是一個簡單的 ref struct 範例：ref struct StackOnlyPoint { public int X; public int Y; } 寫法跟一般結構沒有太大差別，只是宣告的時候多加了 ref 關鍵字。不過，ref struct 有許多嚴格的限制，包括：不能作為類別或一般結構的欄位。C# 13 之前不能實作介面；C# 13 開始能實作介面，但無法轉型為介面型別。不能裝箱（boxing）。不能用於陣列元素。不能在非同步方法中使用。不能在 Lambda 運算式或區域函式中使用（除非該 Lambda/區域函式本身也不會造成堆積配置）。以下列舉幾個範例來分別展示違反相關限制而導致編譯錯誤的寫法。(1) 不

  2026/2/4 22:18Michael Tsaihttps://www.huanlintalk.com/2026/02/demystifying-csharp-ref-struct.html

  

• 重訪 C# 空值安全（下）：擁抱 Nullable Reference Types

  • #C++
  • #.NET

  之前寫過同樣主題的筆記，這次涵蓋 C# 14，更完整，也添加更多細節。分為上下兩集，這是下集。上一篇文章討論了 Nullable 實值型別以及各種方便好用的 null 運算子（如 ?. 和 ??），這些工具讓我們能優雅地處理空值。但這仍然不夠。因為在 C# 8 以前，參考型別（reference types，如 string、List、自訂類別）預設都是可以為 null 的。這意味著變數隨時可能變成地雷。直到 C# 8.0 引入了 Nullable Reference Types (NRT)，我們終於能讓編譯器幫我們把關。什麼是 Nullable Reference Types？簡單來說，NRT 讓編譯器開始能夠區分「可以為 null」和「不可為 null」的參考型別。啟用 NRT 後（.NET 6+ 專案預設啟用），變數的宣告方式發生了根本性的改變：string name1; // 不可為 null (Non-nullable) string? name2; // 可為 null (Nullable) 注意這裡的 ?：它現在不僅適用於 int? 等實值型別，也適用於參考型

  2026/2/1 10:25Michael Tsaihttps://www.huanlintalk.com/2026/02/revisiting-csharp-null-safety-part-2.html

  

• 重訪 C# 空值安全（上）：更方便優雅的語法

  • #C++
  • #.NET

  之前寫過同樣主題的筆記，這次涵蓋 C# 14，更完整，也添加更多細節。分為上下兩集，這是上集。C# 從最初的版本開始，就不斷演進其空值處理機制。從 C# 2.0 的 Nullable Value Types (T?)，到各種 null 運算子（??、?.），再到 C# 8 的 Nullable Reference Types，每一步都是為了讓「空值」這件事變得更明確、可追蹤、可由編譯器檢查。本文要介紹現代 C# 的空值安全機制（null safety），分為上下兩集，涵蓋 C# 14。這是上集，從基礎觀念與語法糖談起。為什麼需要空值安全？在傳統 C# 中，參考型別的變數預設可以是 null：string name = null; // 完全合法 int length = name.Length; // 運行時爆炸：NullReferenceException 這種寫法有下列問題：成本高昂：NullReferenceException 長期以來都是 .NET 應用程式中最常見的崩潰原因之一。隱蔽性強：編譯器無法在編譯時期發現這些問題，只能等到執行時才爆發。難以追蹤：在大型專案中，null

  2026/2/1 09:50Michael Tsaihttps://www.huanlintalk.com/2026/02/revisiting-csharp-null-safety-part-1.html

  

• C# 14 新功能：field 關鍵字

  • #C++
  • #.NET

  C# 14 的新特性：field 關鍵字。C# 14 引入了 field 關鍵字，讓你在屬性存取器中可以直接存取編譯器產生的背後欄位（backing field），無需手動宣告私有欄位。這是自動實作屬性的一個重大改進。以往寫法在 C# 14 之前，如果需要在 setter 中加入驗證邏輯，你必須手動宣告私有欄位：// C# 13 及更早版本 private int _age; public int Age { get => _age; set { if (value < 0) throw new ArgumentException("年齡不可為負數！"); _age = value; } }現代寫法從 C# 14 開始，使用 field 關鍵字，可以省去私有欄位的宣告：// C# 14：使用 field 關鍵字 public int Age { get; // 編譯器自動產生 getter set { if (value < 0) throw new ArgumentException("年齡不可為負數！"); field = value; // field 代表編譯器產生的背後欄位

  2026/1/29 22:43Michael Tsaihttps://www.huanlintalk.com/2026/01/csharp-14-field-keyword.html

  

• Agent Skills 使用心得（之二）

  • #ai

  再稍微整理一下 agent skills 使用心得。

  2026/1/25 11:28Michael Tsaihttps://www.huanlintalk.com/2026/01/agent-skills-notes-2.html

  

• 引號在排版時產生的幽靈空隙

  • #寫作與出版
  • #技術寫作

  再次整理排版時碰到的引號與幽靈空隙（ghost space）的問題與解法。

  2026/1/25 10:36Michael Tsaihttps://www.huanlintalk.com/2026/01/apostrophes-and-ghost-spaces-in.html

  

• Get started authoring Antigravity Skills

  • #ai

  簡單整理一下 Antigravity Skills 編寫入門。

  2026/1/20 19:39Michael Tsaihttps://www.huanlintalk.com/2026/01/get-started-authoring-antigravity-skills.html

  

• Blazor 在 .NET 11 的未來發展

  • #.NET

  本文整理 Blazor 在 .NET 11 中的各項改進。

  2026/1/15 23:52Michael Tsaihttps://www.huanlintalk.com/2026/01/the-future-of-blazor-in-net-11.html

  

• 蛛網交易策略精要

  • #非關 IT

  續 上一篇文章 ，幫忙轉傳推廣《蛛網策略》。

  2026/1/13 22:51Michael Tsaihttps://www.huanlintalk.com/2026/01/spider-web-strategy-essentials.html

  

• 適合工程師的投資法：一個「無聊」但有效的系統

  • #非關 IT

  分享我自己在使用的股票投資方法，和一本相關書籍。

  2026/1/8 23:41Michael Tsaihttps://www.huanlintalk.com/2026/01/an-investment-system-for-engineers.html

  

• 與 AI Agent 協作的小秘訣

  • #ai

  又來分享一點 Antigravity 的使用心得，很簡短的。

  2025/12/3 21:26Michael Tsaihttps://www.huanlintalk.com/2025/12/practical-tips-for-collaborating.html

  

• 我用一週 Antigravity 的心得：為何評價兩極？

  • #ai

  使用 Antigravity 大約一個星期了，有一些心得，以及尚未釐清的疑問，想把它們寫下來。

  2025/11/27 22:29Michael Tsaihttps://www.huanlintalk.com/2025/11/antigravity-why-are-opinions-so-split.html

  

• 我與 AI 處理 .NET Null Reference Warnings 的心得

  • #ai
  • #C++
  • #.NET

  本文整理了 .NET Null Reference Warnings 的核心處理策略，並分享我如何與 AI 合作，在升級舊專案時高效消除數百個警告的實戰心得。

  2025/11/27 20:11Michael Tsaihttps://www.huanlintalk.com/2025/11/fixing-net-null-reference-warnings-with.html

  

• 我配戴連續血糖監測器的第一週心得

  • #非關 IT

  這是我配戴連續血糖監測器（簡稱 CGM）一個星期之後的心得。

  2025/11/2 17:22Michael Tsaihttps://www.huanlintalk.com/2025/11/lessons-from-my-first-week-with-cgm.html

  

• 從 awesome-copilot 裡面挖寶

  • #ai

  從 awesome-copilot 裡面挖寶，裡面有好多提示詞可以參考。

  2025/10/8 19:17Michael Tsaihttps://www.huanlintalk.com/2025/10/treasures-in-awesome-copilot.html

  

• Quarto 筆記 (4) - 單引號怎麼變醜了？

  • #寫作與出版

  Quotation marks look ugly in my Quarto website. Here is how I fix it.

  2025/10/5 20:05Michael Tsaihttps://www.huanlintalk.com/2025/10/quotation-marks-look-ugly-in-my-quarto.html

  

• Quarto 筆記 (3) - 從 Hugo 到 Quarto 的轉換心得

  • #寫作與出版
  • #技術寫作

  這是我從 Hugo 遷移至 Quarto 的心得。

  2025/10/3 06:00Michael Tsaihttps://www.huanlintalk.com/2025/10/from-hugo-to-quarto.html

  

• Quarto 筆記 (2) - 自動發布至 GitHub Pages

  • #寫作與出版
  • #技術寫作

  這篇筆記是關於我如何把 Quarto 文件發布至 GitHub Pages，以及碰到的錯誤和解決方法。

  2025/9/27 11:52Michael Tsaihttps://www.huanlintalk.com/2025/09/publishing-quarto-site-to-github-pages.html

  

• Quarto 筆記 (1) - 初體驗心得

  • #寫作與出版
  • #技術寫作

  我的 Quarto 初體驗心得。

  2025/9/23 22:42永遠的菜鳥https://www.huanlintalk.com/2025/09/quarto-first-impressions.html

  

• 《Google IT Automation with Python》課程心得

  • #IT雜記

  速記一下完訓 Google 專業認證課程的心得。

  2025/9/16 23:33Michael Tsaihttps://www.huanlintalk.com/2025/09/google-it-automation-with-python-course.html

  

• A Follow-up on "Five Lines of Code"

  • #軟體開發
  • #閱讀筆記

  這是之前一篇短文的後續，內容主要是該短文所評論的書籍的作者寫給我的信，以及我的回應。

  2025/8/7 22:54Michael Tsaihttps://www.huanlintalk.com/2025/08/a-follow-up-on-five-lines-of-code.html

• 《衝突溝通的技術》重點整理

  • #閱讀筆記

  寫上一篇筆記〈 愛假裝理性的猴子腦 〉時，書才讀了三分之一左右。現在讀完了，整理一下。

  2025/8/5 21:29Michael Tsaihttps://www.huanlintalk.com/2025/08/read-notes-on-conflict-communication.html

  

• 愛假裝理性的猴子腦

  • #閱讀筆記

  不同政治意識型態的兩邊經常吵得不可開交，但雙方大多覺得自己是理性、中道、正確的那一方（我也是 Orz）。為什麼會這樣呢？也許是猴子腦在作怪。

  2025/7/29 21:32Michael Tsaihttps://www.huanlintalk.com/2025/07/the-monkey-brain-and-politics.html

  

• 我的 AI 翻譯工具使用心得

  • #ai
  • #生產力
  • #技術寫作

  整理一點 AI 翻譯工具的使用心得。

  2025/7/12 22:38Michael Tsaihttps://www.huanlintalk.com/2025/07/my-experience-using-ai-translation-tools.html

• Google 技術寫作課程（中文版）

  • #技術寫作

  我製作了 Google 技術寫作課程的中文版，此貼文包含了課程簡介與連結，可以當作中文版課程的入口。

  2025/7/11 06:47Michael Tsaihttps://www.huanlintalk.com/2025/07/google-technical-writing-courses.html

  

• Gemini CLI 提示詞 for .NET projects

  • #ai
  • #C++
  • #.NET

  摘要： 此筆記整理了幾個我用來重構和改進 .NET 專案的 Gemini CLI 提示詞。

  2025/7/1 22:53Michael Tsaihttps://www.huanlintalk.com/2025/07/gemini-cli-prompts-for-net-projects.html

  

• 批次轉換檔案編碼（Big5 至 UTF-8）

  • #IT雜記

  介紹如何以 PowerShell 和 Python 寫成的自動化腳本來批次轉換檔案的編碼。

  2025/6/30 20:09Michael Tsaihttps://www.huanlintalk.com/2025/06/batch-convert-file-encoding.html

  

• 從 .NET 7 到 9：我的 AI 輔助升級經驗

  • #.NET

  近日將幾個比較舊的 .NET 7 專案升級至 .NET 9，有些東西想記下來。

  2025/6/25 21:31Michael Tsaihttps://www.huanlintalk.com/2025/06/from-net-7-to-9-my-ai-assisted-upgrade.html

  

• 網站維護日誌：升級 Docsy 至 v0.12.0（以及 Hugo）

  • #IT雜記

  我的另一個筆記網站 https://huanlin.cc/ 是以 Hugo 和 Docsy 來建置，最近發現 Docsy 有了新版本：v0.12.0，而且它需要使用 Hugo v0.146.0 之後的版本。此文紀錄了升級這兩個工具的一些重點。

  2025/6/3 23:42Michael Tsaihttps://www.huanlintalk.com/2025/06/upgradig-hugo-based-docsy-website-to.html