Windows下C++中文输出乱码需同时满足:源文件用UTF-8-BOM编码、编译器加/source-charset:utf-8或#pragma execution_character_set("utf-8")、程序启动时调用SetConsoleOutputCP(65001),三者缺一不可。

Windows 控制台默认使用 GBK 编码,而现代 C++ 源文件普遍保存为 UTF-8(尤其 VS 2019+ 新建项目默认),两者不匹配直接导致 std::cout 输出中文变成乱码——这不是 C++ 语言问题,是编码环境错位。
确认源文件编码与编译器读取方式是否一致
VS 中右键源文件 →「高级保存选项」→ 确保编码为 UTF-8 带签名(UTF-8-BOM)。无 BOM 的 UTF-8 文件,MSVC 默认按系统 ANSI(即 GBK)解析字符串字面量,"你好" 实际被当 GBK 解码,再以 UTF-8 发送给控制台,必然乱码。
若坚持用无 BOM UTF-8,需显式告知编译器:
- VS 项目属性 → C/C++ → 命令行 → 追加
/source-charset:utf-8 - 或代码开头加
#pragma execution_character_set("utf-8")(仅 MSVC 有效)
设置控制台输出代码页为 UTF-8
即使源码正确,控制台本身仍可能用 GBK 渲染 UTF-8 字节流。必须在程序启动时调用 SetConsoleOutputCP(65001)(65001 是 UTF-8 的 Windows 代码页 ID)。
立即学习“C++免费学习笔记(深入)”;
注意:该 API 仅对当前进程生效,且需在任何 std::cout 输出前调用:
#include#include int main() { SetConsoleOutputCP(65001); // 必须放最前 std::cout << "你好,世界!" << std::endl; return 0; }
若跳过这步,哪怕源码和编译都对,控制台仍按旧代码页解释字节,显示为“浣犲ソ锛屼笘鐣岋紒”之类。
避免 std::wcout 的陷阱(宽字符方案慎用)
有人尝试改用 std::wcout + L"你好",但这条路更易出错:
-
std::wcout默认不启用,需先调用std::wcout.imbue(std::locale("")) - Windows 控制台对 UTF-16 支持不完整,
SetConsoleOutputCP(CP_UTF8)对wcout无效 - VS 调试控制台(非 cmd.exe)对宽字符输出常有兼容问题
除非明确需要处理 Unicode 全字符集(如 emoji、中日韩越统一汉字变体),否则优先走 char + UTF-8-BOM + SetConsoleOutputCP(65001) 这条路径,稳定且轻量。
跨平台可移植性提醒
上述 SetConsoleOutputCP 是 Windows API,在 Linux/macOS 下会编译失败。若需跨平台:
- Linux/macOS 终端原生支持 UTF-8,只要终端 locale 是
en_US.UTF-8或zh_CN.UTF-8,且源文件为 UTF-8,std::cout即可正常工作 - 可封装条件编译:
#ifdef _WIN32内调用SetConsoleOutputCP - 避免依赖
system("chcp 65001"),它新开子进程,不影响当前进程代码页
真正容易被忽略的点:BOM 和代码页设置缺一不可,且顺序不能颠倒——先让编译器“读懂”字符串,再让控制台“看懂”字节流。











