c# 12 引入 $"""...""" 语法支持多行字符串插值,插值表达式可跨行且无需转义,自动缩进修剪仅在各行缩进一致时生效,编译期展开无运行时开销。

多行字符串插值在 C# 12(.NET 8)中如何写
直接用 $""" 开头、""" 结尾的原始字符串字面量,就能天然支持多行 + 插值。这不是“改进”,而是 C# 12 正式引入的语法:原始字符串字面量(raw string literals)与内插功能的融合。
关键点是:插值符号 {...} 在原始字符串中照常工作,且换行、缩进、引号都不需要转义。
常见错误现象:$"line1\nline2" 或 @$"line1{value}..." 这类写法仍受限于传统字符串规则,无法优雅处理真正复杂的多行结构。
-
$"""必须紧挨着$,不能有空格($ """是非法的) - 结束的
"""必须独占一行或紧跟内容后(但推荐独占一行以对齐) - 大括号内的表达式支持完整 C# 语法,包括换行、方法调用、条件运算符
缩进怎么处理才不把空格带到结果里
原始字符串默认保留所有空白字符,包括缩进——这常导致输出意外的前导空格。C# 12 引入了“自动缩进修剪”(automatic indentation trimming),但仅当所有非空行拥有相同前缀空白时才生效。
实际效果取决于你写的格式:
- 如果每行都缩进 4 空格,且结束
"""也顶格写,则运行时会自动删掉这 4 空格 - 如果某行缩进 2 空格、另一行 6 空格,修剪失效,所有空格原样保留
- 想强制控制缩进?用
string.TrimStart()或string.Replace("\n ", "\n")手动清理(不推荐) - 更稳妥的做法:让代码块左对齐,用变量拼接或
StringBuilder构造逻辑复杂的内容
插值表达式里能换行吗?比如 {GetUser().Name} 太长想拆开
可以,只要语法合法。C# 12 允许插值表达式本身跨行,前提是它是一个完整的、可解析的表达式。
例如下面写法完全有效:
$"""
Name: {
GetUser()
.WithLogging()
.Name
}
Age: {DateTime.Now.Year - birthYear}
"""但注意这些限制:
- 不能在
{和表达式之间换行({\nGetUser()}报错) - 不能在表达式中间断开不完整语法(如
{list.Where(换行后没闭合) - 三元运算符、lambda 表达式需用括号包裹,否则易被解析器误判
.NET 8 运行时对多行插值有额外开销吗
没有额外运行时开销。编译器在编译期就把 $"""...""" 展开为常规字符串拼接或 string.Concat 调用,和传统插值行为一致。
性能影响只发生在编译阶段(解析原始字符串结构稍复杂),但对绝大多数项目可忽略。
真正要注意的是可读性陷阱:
- 嵌套多层插值 + 多行表达式会让调试困难,VS 的断点可能无法精准停在某一行插值上
- 若插值内容含敏感信息(如密码、token),日志打印该字符串时容易意外泄露整块结构
- 团队协作中,有人习惯用
$@"",有人用$""",混用可能导致风格割裂和合并冲突
最易被忽略的一点:原始字符串的终止 """ 如果没对齐好,编译器报错信息非常模糊,常显示 “unterminated string literal” 而不提示具体哪一行漏了引号——建议编辑器开启 raw string 高亮支持(Visual Studio 2022 17.8+ 默认启用)。









