Windows控制台默认GBK编码导致UTF-8中文输出乱码，需改代码页为65001、项目设Unicode、源文件存为UTF-8带BOM，并用std::wcout配合std::locale::global()和imbue()正确设置本地化。
Windows 控制台默认编码不是 UTF-8
直接用 std::cout 输出中文字符串（如 "你好"），在 VS 默认配置下大概率显示为问号或方块——这不是代码写错了，而是控制台的活动代码页（Active Code Page）默认是 GBK（CP936），而源文件保存为 UTF-8 时，字节序列不匹配导致解码失败。
常见错误现象：???、???、空格乱跳、std::cout 输出后光标错位，甚至 std::wcout 报 bad_cast 或直接崩溃。
- 确认当前代码页：命令行运行
chcp，输出类似活动代码页: 936 - 临时切换到 UTF-8：执行
chcp 65001（但仅对当前终端有效，且部分旧版 Windows 对 UTF-8 支持不完整） - VS 项目需同步设置：右键项目 → 属性 → 配置属性 → 常规 → “字符集” 改为
使用 Unicode 字符集（启用wchar_t支持） - 源文件必须保存为带 BOM 的 UTF-8（VS 中“另存为”→ 编码选
UTF-8 带签名），否则编译器可能按系统默认编码读取
用 std::wcout 替代 std::cout 并设置本地环境
std::cout 是窄字符流，底层依赖 char 和当前代码页；而 std::wcout 处理 wchar_t，配合正确的本地环境（locale）才能映射到控制台真实编码。
关键操作不是“加 L 前缀就完事”，而是必须显式调用 std::locale::global() 和 std::wcout.imbue()：
立即学习“C++免费学习笔记（深入）”；
#include <iostream>
#include <locale>
#include <string>
int main() {
// 必须设全局 locale，否则 wcout 可能仍走 C locale
std::locale::global(std::locale("")); // 使用系统默认 locale（Windows 下即 CP936 或 CP65001）
std::wcout.imbue(std::locale()); // 让 wcout 绑定该 locale
std::wcout << L"你好，世界！" << std::endl;
return 0;
}
- 如果只写
L"你好"但没设 locale，wcout仍按"C"locale 解释宽字符，输出必然乱码 -
std::locale("")在 Windows 上会解析注册表中的系统 locale，通常对应 GBK；若已执行过chcp 65001，可尝试std::locale("Chinese_China.65001")（但兼容性差，不推荐） - 注意：VS 调试器“输出”窗口不支持宽字符渲染，务必在外部命令行（cmd/powershell）中运行程序验证
跨平台兼容方案：避免依赖控制台编码
真正健壮的做法，是绕开控制台编码问题本身——把中文输出转成系统能认的窄字符序列，而不是让控制台硬扛 UTF-16/UTF-8。
Windows 下可用 WideCharToMultiByte 手动转换（需 windows.h）：
#include <windows.h>
#include <iostream>
#include <string>
std::string utf8_to_gbk(const std::wstring& wstr) {
int len = WideCharToMultiByte(CP_ACP, 0, wstr.c_str(), -1, nullptr, 0, nullptr, nullptr);
std::string str(len, 0);
WideCharToMultiByte(CP_ACP, 0, wstr.c_str(), -1, &str[0], len, nullptr, nullptr);
return str;
}
int main() {
std::wstring wmsg = L"你好，世界！";
std::cout << utf8_to_gbk(wmsg); // 输出 GBK 编码的 char 字符串
return 0;
}
-
CP_ACP表示系统 ANSI 代码页（即 GBK），确保输出与chcp显示值一致 - 此法不依赖
wcout或 locale 设置，适合需要稳定输出的工具类程序 - Linux/macOS 不需要这套——它们终端原生支持 UTF-8，只要源文件存为 UTF-8 且未强制改 locale，
std::cout << "你好"就能工作
VS 编译器和 C++ 标准版本的影响
Visual Studio 2015 及以后版本对 UTF-8 源文件的支持有明显改进，但仍有细节陷阱：
- VS 2019/2022 默认启用
/utf-8编译开关（项目属性 → C/C++ → 命令行 → 附加选项），它会让编译器把源文件当作 UTF-8 处理，并影响字符串字面量编码 - 若关闭
/utf-8，即使文件存为 UTF-8，"你好"也会被当 GBK 解析，导致strlen异常、std::string构造出错 - C++20 引入
u8"..."前缀，明确声明 UTF-8 字符串字面量，但 Windows 控制台仍需配套的代码页或转换逻辑，不能单靠语法解决输出问题 - 调试时观察变量值：在监视窗口里看
std::string内容是否正常显示中文，可快速判断是源码读取问题还是输出通道问题
