c# string interpolation 字符串插值

字符串插值中$必须紧邻引号,中间不可有空格或换行;{}内仅支持表达式,不支持语句;null值默认转为字符串"null",需用??处理;性能上常量插值优化良好,但循环中应避免复杂表达式。

字符串插值里 $ 必须紧挨着引号,不能有空格或换行

这是最常踩的语法错误:写成 $ "Hello {name}" 或换行后加 $,编译器直接报错 CS1056: Unexpected character '$'。C# 要求 $" 必须连在一起,中间不能有任何字符(包括空格、制表符、换行)。

  • $"Hello {name}" ✅ 正确
  • $ "Hello {name}" ❌ 编译失败
  • $
    "Hello {name}"
    ❌ 编译失败(换行破坏了 token 连续性)
  • 如果字符串太长需换行,用 + 拼接或逐行插值,不要拆开 $ 和引号

{} 里只能放表达式,不能放语句或声明

插值占位符本质是表达式上下文,不支持 iffor、变量声明等语句。想实现条件逻辑,得提前算好值,或用三元运算符。

  • $"Price: {price > 100 ? "expensive" : "ok"}" ✅ 可以
  • $"Name: {string name = "Tom"; name.ToUpper()}" ❌ 编译错误:CS0201: Only assignment, call, increment, decrement, and new object expressions can be used as a statement
  • 复杂逻辑建议提取到局部变量:
    var status = user.IsActive ? "active" : user.IsPending ? "pending" : "blocked";
    var msg = $"User {user.Name} is {status}";

插值字符串默认调用 .ToString(),但 null 值会变成字符串 "null"

这和 string.Format 行为一致,但容易在日志或 UI 中意外显示字面量 "null",而不是空字符串或占位符。

  • string name = null; $"Hello {name}""Hello null",不是异常,也不是空字符串
  • 避免方式:用空合并运算符 ?? 显式处理:$"Hello {name ?? "(unknown)"}"
  • 若对象重载了 ToString(),插值会调用它;若没重载,默认是类型全名,比如 new List() 插入后得到 "System.Collections.Generic.List`1[System.Int32]"

性能上,简单插值和 string.Concat 几乎无差别,但嵌套插值或多次拼接要小心

C# 编译器对常量插值(如 $"Hi {name}")会优化成 string.Concat 调用,开销极小。但若在循环里反复拼接大量插值字符串,尤其含复杂表达式,可能触发多次临时字符串分配。

  • 高频场景(如日志、序列化)中,避免在插值里调用耗时方法:$"Time: {DateTime.Now.ToString("HH:mm:ss")}" → 改成先计算再插值
  • 大量字段拼接推荐用 StringBuilder,而非链式插值:$"{a}{b}{c}{d}{e}{f}{g}" 在编译期虽被优化,但可读性和维护性差
  • .NET 6+ 支持 string.Create 配合 Span 零分配格式化,但插值本身不参与该路径,需手动改写

插值看着简单,真正容易出问题的地方不在语法,而在隐式调用 ToString() 的时机、null 处理的惯性忽略,以及把“写起来顺手”当成“运行时高效”的错觉。