Windows 10控制台无法打印UTF-8字符串首字符的技术求助

这是个挺典型的Windows控制台UTF-8兼容坑，我来帮你拆解原因和解决办法：

问题根源 #

Windows原生CMD的UTF-8支持（代码页65001）存在一个历史bug：当C++标准库的输出流（cout/printf）首次输出的是多字节UTF-8字符的首字节时，控制台会错误地忽略这个字节；而如果先输出一个ASCII字符（比如空格），就会触发控制台正确的编码解析逻辑。

Rust的标准库在Windows下做了特殊适配，底层直接调用Windows API处理控制台输出，规避了这个bug；但C++标准库默认没有做这个处理，所以会出现你看到的差异。

具体解决办法 #

下面给你几种可行的方案，按推荐优先级排序：

方案1：用Windows API强制设置控制台编码 + 配置Locale #

直接通过Windows API修改当前进程的控制台编码，同时配置C++标准流的locale，让流正确识别UTF-8：

修改后的完整代码：

// utf8 source file encoding
#include <iostream>
#include <iomanip>
#include <cstdio>
#include <windows.h> // 引入Windows API头文件

int main() {
    // 直接设置控制台输入/输出编码为UTF-8，比system("chcp")更可靠
    SetConsoleCP(CP_UTF8);
    SetConsoleOutputCP(CP_UTF8);

    // 配置标准流的locale，确保正确处理UTF-8字符
    std::locale::global(std::locale(""));
    std::cout.imbue(std::locale());
    std::wcout.imbue(std::locale());

    const char* utf8 = u8"Привет Мир";
    const char* utf8s = u8" Привет Мир";

    std::cout << "cout\n";
    std::cout << utf8 << std::endl;
    std::cout << utf8s << std::endl;
    std::cout << utf8 << std::endl;
    std::cout << std::flush;

    std::wcout << L"wcout\n";
    std::wcout << L"Привет Мир" << std::endl;
    std::wcout << L" Привет Мир" << std::endl;
    std::wcout << L"Привет Мир" << std::endl;
    std::wcout << std::flush;

    std::printf("printf\n");
    std::printf("%s\n", utf8);
    std::printf("%s\n", utf8s);

    std::wprintf(L"wprintf\n");
    std::wprintf(L"Привет Мир\n");
    std::wprintf(L" Привет Мир\n");
    std::wprintf(L"Привет Мир\n");

    std::fflush(stdout);
    std::system("pause");
    return 0;
}

关键修改点说明：

• SetConsoleCP/SetConsoleOutputCP：直接修改当前进程的控制台编码，比system("chcp 65001")更可靠（system是启动子进程修改，可能当前进程的编码未同步）。
• std::locale配置：让C++标准流（cout/wcout）适配当前控制台的UTF-8编码，避免多字节字符解析错误。

方案2：直接调用Windows API输出（绕过C++标准流） #

如果方案1还存在兼容问题，可以直接用Windows的WriteConsoleW API输出宽字符，完全绕过C++标准库的流逻辑，和Rust的处理方式一致：

添加一个自定义输出函数：

void print_utf8(const char* utf8_str) {
    // 把UTF-8字符串转成宽字符
    int wstr_len = MultiByteToWideChar(CP_UTF8, 0, utf8_str, -1, nullptr, 0);
    wchar_t* wstr = new wchar_t[wstr_len];
    MultiByteToWideChar(CP_UTF8, 0, utf8_str, -1, wstr, wstr_len);

    // 直接写入控制台
    HANDLE console_out = GetStdHandle(STD_OUTPUT_HANDLE);
    WriteConsoleW(console_out, wstr, wstr_len - 1, nullptr, nullptr);

    delete[] wstr;
}

然后在代码中替换cout/printf调用：

print_utf8("cout\n");
print_utf8(utf8);
print_utf8("\n");

这种方式完全规避了C++标准库和CMD的兼容问题，效果最稳定。

临时应急方案：先输出一个空字符 #

如果不想修改太多代码，可以在首次输出UTF-8字符串前，先输出一个空字符（比如std::cout << '\0';），触发控制台的编码解析逻辑，这样后续的俄语字符就能正常输出。不过这只是临时 workaround，不推荐作为长期解决方案。

为什么Git Bash没问题？ #

Git Bash是基于MinGW的类Unix终端环境，它对UTF-8的支持是模拟类Unix系统实现的，没有Windows原生CMD的这个历史bug，所以你的程序在Git Bash下能正常运行。

内容的提问来源于stack exchange，提问作者leanid.chaika