为何MSVC的/utf-8编译选项无法让程序正常显示Unicode字符？

问题现象 #

Windows 10/11的系统区域设置里有个测试版选项「为全球语言支持使用Unicode UTF-8」，启用后所有ANSI Win32系统调用会把字符串当作UTF-8处理。此时用MSVC编译以下代码能正常输出：

int main() {
    std::cout << "Hello, World! こんにちは世界!" << std::endl;
    // 输出：Hello, World! こんにちは世界!
}

但如果关闭这个全局选项，仅用/utf-8编译选项编译程序，会出现乱码问题：

1. 给字符串加u8前缀，输出乱码：

int main() {
    std::cout << u8"Hello, World! こんにちは世界!" << std::endl;
    // 输出：Hello, World! πüôπéôπü½πüíπü»Σ╕ûτòî!
}

2. 调用setlocale设置UTF-8 locale，输出仍乱码：

int main() {
    setlocale(LC_ALL, "en_US.utf-8");
    std::cout << "Hello, World! こんにちは世界!" << std::endl;
    // 输出：Hello, World! ???????!
}

问题根源 #

1. 控制台代码页不匹配：Windows控制台默认使用系统区域对应的ANSI代码页（比如中文系统是GBK），即使编译时用/utf-8指定了源文件和执行字符集为UTF-8，std::cout输出时会把UTF-8字节按当前控制台代码页解析，导致乱码。
2. locale参数错误：Windows平台的setlocale不支持Linux风格的en_US.utf-8命名，正确的UTF-8 locale格式应为".UTF-8"或"en-US.UTF-8"，且仅设置locale不修改控制台代码页也无法解决输出乱码。

解决方法 #

方案1：设置控制台UTF-8代码页 #

直接调用Windows API将控制台输出代码页设为UTF-8，配合/utf-8编译选项即可正常输出：

#include <iostream>
#include <windows.h>

int main() {
    SetConsoleOutputCP(CP_UTF8); // 设置控制台输出代码页为UTF-8
    std::cout << "Hello, World! こんにちは世界!" << std::endl;
    // 正常输出预期内容
}

方案2：正确设置Locale + 控制台代码页 #

如果需要依赖C标准库的locale机制，需使用Windows兼容的locale名称，同时修改控制台代码页：

#include <iostream>
#include <clocale>
#include <windows.h>

int main() {
    SetConsoleOutputCP(CP_UTF8);
    setlocale(LC_ALL, ".UTF-8"); // Windows兼容的UTF-8 locale格式
    std::cout << "Hello, World! こんにちは世界!" << std::endl;
}

方案3：使用宽字符输出 #

利用Windows的宽字符支持，通过std::wcout输出宽字符串，同样需要确保控制台环境支持：

#include <iostream>
#include <windows.h>

int main() {
    SetConsoleOutputCP(CP_UTF8);
    std::wcout << L"Hello, World! こんにちは世界!" << std::endl;
}

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