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 控制台程序。需包含 <windows.h></windows.h>,并在 main() 开头调用:
#include <iostream>
#include <windows.h>
int main() {
SetConsoleOutputCP(CP_UTF8);
std::cout
<ul>
<li>必须在任何 <code>std::cout</code> 输出前调用,否则已缓冲的内容仍按旧编码输出</li>
<li>
<code>CP_UTF8</code> 定义在 <code>windows.h</code> 中,值为 <code>65001</code>
</li>
<li>该设置只影响当前进程的控制台输出,不影响输入或其它进程</li>
<li>若控制台字体不支持中文(如 Raster Fonts),即使编码正确也会显示方块——需右键属性 → 字体 → 选“Lucida Console”或“Consolas”</li>
</ul>
<h3>源文件编码、编译器选项与 <code>std::wcout</code> 配合使用</h3>
<p>纯 UTF-8 + <code>SetConsoleOutputCP</code> 能解决大多数情况,但若要更健壮地处理中文(尤其含 emoji 或生僻字),可改用宽字符流:</p>
<ul>
<li>源文件必须保存为 UTF-8 with BOM(VS 默认创建即满足)</li>
<li>添加 <code>#include <io.h></io.h></code> 和 <code>#include <fcntl.h></fcntl.h></code>
</li>
<li>在 <code>main()</code> 开头加:<code>_setmode(_fileno(stdout), _O_U16TEXT);</code>
</li>
<li>改用 <code>std::wcout ,字符串前加 <code>L</code></code>
</li>
<li>注意:<code>std::wcout</code> 不兼容 <code>std::endl</code>,应使用 <code>L"\n"</code> 或 <code>std::wcout </code>
</li>
</ul>
<h3>跨平台可移植性差,Linux/macOS 下无需额外设置</h3>
<p>Linux 终端和 macOS Terminal 默认使用 UTF-8,只要源文件是 UTF-8 编码,<code>std::cout 就能正常工作。但 Windows 上这套逻辑完全不适用——别指望加个 <code>#ifdef _WIN32</code> 就一劳永逸。真正需要跨平台时,建议:</code></p>
<ul>
<li>统一用 UTF-8 源码 + <code>SetConsoleOutputCP</code>(Windows) + 纯 UTF-8(其他平台)</li>
<li>避免依赖控制台原生命令(如 <code>system("chcp 65001")</code>),它会改变整个终端状态且不可靠</li>
<li>如果程序要打包分发,务必测试目标机器是否安装了中文字体;某些精简版 WinPE 或 Server Core 可能连基本中文字体都没有</li>
</ul>
控制台中文不是“能不能输出”的问题,而是“编码链路是否全程对齐”:源码编码 → 编译器解释 → 运行时输出 API → 控制台解码 → 字体渲染。任一环断裂,就只剩问号和方块。</windows.h></iostream>C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











