C# 11原始字符串字面量用三个双引号"""定义,免转义引号、反斜杠和换行;要求首尾"""独占一行且缩进对齐,自动去除各行最小公共前导空格;含"""时需扩展为更多引号;支持$"""插值。

C# 11 引入的原始字符串字面量(raw string literals)能帮你轻松处理包含大量引号、反斜杠或换行的字符串,比如 JSON、正则表达式、SQL 或多行文本,不用再手动转义。
基本写法:用三个双引号开始和结束
最简形式是连续三个双引号 """ 包裹内容,内部所有字符(包括换行、空格、引号、反斜杠)都按字面意思保留:
示例:
string json = """{"name": "Alice", "age": 30}""";
string path = """C:\Users\Alice\Documents\file.txt""";
string multiline = """Line 1
Line 2
Indented line""";注意:开头的 """ 必须独占一行(可带缩进),结尾的 """ 也必须独占一行,且缩进需对齐——这是关键细节,否则编译报错。
处理缩进:自动去除公共前导空格
原始字符串会智能计算所有非空行的**最小缩进量**,并从每行中去掉这部分空格:
- 第一行(开头
"""后)和最后一行(结尾"""前)不参与缩进计算 - 空行或只含空白符的行会被忽略
- 实际内容从第一个非空行开始算起
例如:
string html = """
<div>
<p>Hello</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill10595" title="htmlppt.skill"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d79f23518.jpg" alt="htmlppt.skill" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill10595" title="htmlppt.skill">htmlppt.skill</a>
<p>把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。</p>
</div>
<a href="/xiazai/skill10595" title="htmlppt.skill" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
</div>
""";生成的字符串是:"<div>\n <p>Hello</p>\n</div>"(首尾换行保留,中间缩进统一为 4 个空格)。
嵌套引号与特殊字符:无需转义,但需注意终止序列
原始字符串里可以自由写 "、\、\n 等,完全不用加 \;唯一需要“转义”的是终止符本身——即连续三个双引号 """。
如果字符串内容真要包含 """,就用更多引号扩展边界:
- 用
""""""(六个)表示字符串内含""" - 用
"""""""(七个)表示字符串内含"""" - 规则:结尾至少要比开头多一个双引号,且开头结尾引号数必须相同
例子:
string withTripleQuote = """""This is """ inside"""""; // → "This is """ inside" string sql = """SELECT * FROM users WHERE name = """"Alice"""";""";
与插值结合:使用 $""" 开头
原始字符串支持插值,只需在开头加 $,语法和普通插值一样,但大括号内表达式仍需正常书写:
string name = "Bob";
int count = 5;
string message = $"""Hello {name},
You have {count} new messages.
Path: C:\Logs\{name}.log""";注意:$""" 和 """ 之间不能有空格;插值大括号不会受原始规则影响,依然按 C# 表达式解析。
基本上就这些。掌握缩进对齐规则和终止符扩展机制,就能把原始字符串用得既安全又顺手。

















