原始字符串字面量写作r"delimiter(content)delimiter",分隔符由字母数字下划线组成且不能数字开头,内容含换行反斜杠双引号均不转义;u8r""强制utf-8编码,r""无编码约束;多用于正则、路径、sql等免转义场景。

原始字符串字面量的基本写法是 R"delimiter(content)delimiter"
它不是用引号加转义,而是靠一对自定义分隔符包裹内容,中间所有字符(包括换行、反斜杠、双引号)都按字面意思处理。分隔符可以是空字符串(即 R"(content)"),但更推荐用带标识的,比如 R"xyz(content)xyz",避免内容里恰好出现 )" 导致提前截断。
常见错误是漏掉结尾的分隔符或括号不匹配,编译器会报类似 error: missing terminating " character 或更迷惑的解析错误——其实只是 ) 没对上。
- 分隔符必须由字母、数字、下划线组成,且不能以数字开头(如
1abc不合法,abc1可以) - 分隔符本身不参与字符串内容,
R"foo( )foo"的值就是两个字符:和n,不是换行 - 原始字符串不能直接嵌套,但可以相邻拼接:
R"(a)" R"(b)"等价于"ab"
什么时候必须用原始字符串?
典型场景是正则表达式、Windows 路径、SQL 片段、多行 HTML 模板——这些内容天然含大量 或 ",用普通字符串要疯狂转义,可读性极差。
比如匹配 Windows 路径的正则:R"((C:\\|\\\\)[^"\r\n]+)" 写成普通字符串就得写成 "(C:\\\\|\\\\\\\\)[^\"\r\n]+",一眼看不出逻辑。
再比如写一个含双引号的 JSON 片段:R"({"name":"Alice","age":30})",不用逃逸 ",也不用拼接。
R"(...)" 和 u8R"(...)" 的区别
前者是窄字符串(const char*),后者强制 UTF-8 编码,内容会被当作 UTF-8 字节序列处理。如果原始字符串里有中文或 emoji,又希望确保编码一致,优先用 u8R"(...)"。
但注意:源文件编码必须是 UTF-8(现代编辑器默认如此),否则 u8R 里的非 ASCII 字符可能被误读。GCC/Clang 默认按 UTF-8 解析源码,MSVC 需加 /utf-8 参数。
-
R"(...)":类型为const char[N],内容不做编码检查 -
u8R"(...)":类型也是const char[N],但编译器保证字节流是合法 UTF-8(非法时编译失败) - 没有
uR或UR形式的原始宽字符串;要用宽字符得写成L"..."并手动转义
容易忽略的细节:换行和缩进也照单全收
原始字符串里的换行符、空格、制表符全部保留。写多行 SQL 时,如果缩进对齐,生成的字符串开头就有空格,可能触发语法错误。
例如:
R"( SELECT * FROM users WHERE id = ? )"
实际值是 "
SELECT * FROM users
WHERE id = ?
",首尾都有换行。调试时用 std::cout 能看清真实内容。
解决办法:把起始 " 和内容紧贴写,或者用括号外的换行控制格式:
R"(SELECT * FROM users WHERE id = ?)"
或者用宏或构建时预处理来 strip 前后空白——原始字符串本身不提供 trim 功能。
原始字符串的“原始”是双刃剑:省去转义的同时,也放弃了一切格式干预能力。写之前先想清楚哪些空白和换行是语义必需的,哪些只是编辑器排版习惯。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











