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="/ai/1915" title="Summarizer"><img
src="https://www.herecours.com/d/file/efpub/2026/21-21/20260221140058179491.jpg" alt="Summarizer" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1915" title="Summarizer">Summarizer</a>
<p>基于 AI 的文本段落摘要生成器</p>
</div>
<a href="/ai/1915" title="Summarizer" 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# 表达式解析。
基本上就这些。掌握缩进对齐规则和终止符扩展机制,就能把原始字符串用得既安全又顺手。
