Windows控制台默认不支持UTF-8,需调用SetConsoleOutputCP(CP_UTF8)并设置兼容字体才能正确输出中文;跨平台应统一源码为UTF-8,Windows额外配置编码与字体,Linux/macOS默认支持。

Windows 控制台默认不支持 UTF-8,std::cout 输出中文会乱码
根本原因是 Windows 控制台(conhost.exe)在旧版系统中默认使用 GBK(如 CP936)编码,而 C++ 源文件若保存为 UTF-8(无 BOM),std::string 字面量中的中文就会被当作多字节序列错误解析。即使源码是 UTF-8,std::cout 也不会自动转码输出。
用 SetConsoleOutputCP(CP_UTF8) 切换控制台输出编码
这是最直接有效的方案,适用于 Visual Studio 编译的 Windows 控制台程序。需包含 ,并在 main() 开头调用:
#include#include int main() { SetConsoleOutputCP(CP_UTF8); std::cout << "你好,世界!" << std::endl; return 0; }
- 必须在任何
std::cout输出前调用,否则已缓冲的内容仍按旧编码输出 -
CP_UTF8定义在windows.h中,值为65001 - 该设置只影响当前进程的控制台输出,不影响输入或其它进程
- 若控制台字体不支持中文(如 Raster Fonts),即使编码正确也会显示方块——需右键属性 → 字体 → 选“Lucida Console”或“Consolas”
源文件编码、编译器选项与 std::wcout 配合使用
纯 UTF-8 + SetConsoleOutputCP 能解决大多数情况,但若要更健壮地处理中文(尤其含 emoji 或生僻字),可改用宽字符流:
- 源文件必须保存为 UTF-8 with BOM(VS 默认创建即满足)
- 添加
#include和#include - 在
main()开头加:_setmode(_fileno(stdout), _O_U16TEXT); - 改用
std::wcout ,字符串前加L - 注意:
std::wcout不兼容std::endl,应使用L"\n"或std::wcout
跨平台可移植性差,Linux/macOS 下无需额外设置
Linux 终端和 macOS Terminal 默认使用 UTF-8,只要源文件是 UTF-8 编码,std::cout 就能正常工作。但 Windows 上这套逻辑完全不适用——别指望加个 #ifdef _WIN32 就一劳永逸。真正需要跨平台时,建议:
立即学习“C++免费学习笔记(深入)”;
- 统一用 UTF-8 源码 +
SetConsoleOutputCP(Windows) + 纯 UTF-8(其他平台) - 避免依赖控制台原生命令(如
system("chcp 65001")),它会改变整个终端状态且不可靠 - 如果程序要打包分发,务必测试目标机器是否安装了中文字体;某些精简版 WinPE 或 Server Core 可能连基本中文字体都没有











