C# 字符串插值 $ 符號缺失導致變量不替換：Console.WriteLine 正確用法

錯誤代碼

string name = "張三";
Console.WriteLine("Hello, {name}."); // 輸出: Hello, {name}.

原因

普通字符串字面量 `"..."` **不支持插值**，大括號內容按原樣輸出。必須在引號前加 `$` 前綴啟用插值語法。

正確代碼

string name = "張三";
Console.WriteLine($"Hello, {name}."); // 輸出: Hello, 張三.

進階插值語法速查

性能提示

• C# 10+ 編譯器優先使用 `DefaultInterpolatedStringHandler` 結構體，**避免 `string.Format` 分配臨時數組/對象**，性能接近 `StringBuilder` 手寫拼接。
• 熱路徑中避免複雜表達式 (如 LINQ 查詢) 直接放入插值，預先計算存入局部變量再插值。
• `$@""` 組合用於文件路徑、SQL、多行模板：`$@"C:\Users\{name}\Docs"`。

常見誤區對比

// 錯誤
"Hello {name}"           // 普通字符串
@"Hello {name}"          // 逐字字符串，仍不插值
String.Format("Hi {0}", name) // 老寫法，性能較差

// 正確
$"Hello {name}"          // 插值字符串
$@"Hello {name}"         // 插值 + 逐字 (路徑/多行)
FormattableString fs = $"Hello {name}"; // 可延遲格式化/本地化