为何printf输出含转义序列的字符串时会出现乱码？

问题重现 #

使用C++17编写文件处理逻辑时，发现用printf输出std::filesystem::path::string()返回的字符串时，控制台会显示奇怪字符，但用cout输出则完全正常。最小可复现代码如下：

#include <iostream>

using namespace std;

int main()
{
    const string PASS_STRING = "This is a test.";
    const string FAIL_STRING = "This\\is not\\a\\test.";

    cout << PASS_STRING << endl;
    cout << "Test passed.\n" << endl;

    printf( "%s\n", FAIL_STRING );
    printf( "Test failed.\n" );

    return 0;
}

运行后，cout能正常输出所有内容，但printf输出FAIL_STRING时会出现乱码，而非预期的This\is not\a\test.。

原因分析 #

问题核心在于**printf是C风格格式化函数，会解析字符串中的转义序列**：

• C语言中，字符串里的\是转义字符，比如\n代表换行、\a代表响铃、\t代表制表符。
• 当printf遇到FAIL_STRING里的\i、\a时，会尝试将其解析为转义序列，但这些并非标准可打印转义，最终会被转换成控制台无法正常显示的控制字符或乱码。
• 而C++的cout属于流输出，会直接输出字符串中的每个原始字符，不会对\做转义解析，因此能正常显示路径中的反斜杠。

解决方案 #

针对这个问题，有几种可行的解决方式：

1. 直接使用C++流输出（推荐） #

既然cout能正常输出，直接替换printf即可，对于std::filesystem::path可以直接输出：

cout << dir_entry.path() << endl;

2. 对字符串中的反斜杠进行转义 #

如果必须使用printf，需要将字符串中的每个\替换为\\，这样printf解析时会将\\转换成单个\输出。可以手动处理或写一个辅助函数：

string escape_backslashes(const string& input) {
    string result;
    for (char c : input) {
        if (c == '\\') {
            result += "\\\\";
        } else {
            result += c;
        }
    }
    return result;
}

// 使用时
printf("%s\n", escape_backslashes(directory).c_str());

3. 使用宽字符版本的格式化函数 #

在Windows环境下，std::filesystem::path内部通常使用宽字符存储路径，可以配合wprintf和path::wstring()使用：

wprintf(L"%ls\n", dir_entry.path().wstring().c_str());

内容的提问来源于stack exchange，提问作者nore