C#怎么使用raw string literals C# 11原始字符串字面量教程

来源:这里教程网 时间:2026-02-21 17:35:04 作者:

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# 表达式解析。

基本上就这些。掌握缩进对齐规则和终止符扩展机制,就能把原始字符串用得既安全又顺手。

相关推荐