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

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

C# 11 引入的原始字符串字面量（raw String literals）能帮你轻松处理包含大量引号、反斜杠或换行的字符串，比如 jsON、正则表达式、sql 或多行文本，不用再手动转义。

基本写法：用三个双引号开始和结束

最简形式是连续三个双引号 """ 包裹内容，内部所有字符（包括换行、空格、引号、反斜杠）都按字面意思保留：

示例：

string json = """{"name": "Alice", "age": 30}"""; string path = """C:UsersAliceDocumentsfile.txt"""; string multiline = """Line 1 Line 2   Indented line""";

注意：开头的 """ 必须独占一行（可带缩进），结尾的 """ 也必须独占一行，且缩进需对齐——这是关键细节，否则编译报错。

处理缩进：自动去除公共前导空格

原始字符串会智能计算所有非空行的 ** 最小缩进量 **，并从每行中去掉这部分空格：

• 第一行（开头 """ 后）和最后一行（结尾 """ 前）不参与缩进计算
• 空行或只含空白符的行会被忽略
• 实际内容从第一个非空行开始算起

例如：

string html = """     <div>         <p>Hello</p>     </div>     """;

生成的字符串是："<div>n <p>Hello</p> <div class="aritcle_card"> <a class="aritcle_card_img" href="/ai/2318"> <img src="https://img.php.cn/upload/ai_manual/001/246/273/175851125796130.png" alt=" 星绘 "> </a> <div class="aritcle_card_info"> <a href="/ai/2318"> 星绘 </a> <p> 豆包旗下 AI 写真、P 图、换装和视频生成 </p> <div class=""> <img src="/static/images/card_xiazai.png" alt=" 星绘 "> <span>429</span> </div> </div> <a href="/ai/2318" class="aritcle_card_btn"> <span> 查看详情 </span> <img src="/static/images/cardxiayige-3.png" alt=" 星绘 "> </a> </div> 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# 表达式解析。

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