C++/Windows 开发中 UTF-8 与 GBK 编码混乱问题及解决
在 Windows 上做 C++/Qt/工具开发的同学，几乎所有人都遇到过以下问题：
- 控制台中文输出乱码
- JSON 文件中出现
"\\u4e2d\\u6587"或奇怪的乱码 - API 处理中文失败、路径乱码、输出文件乱码
- 明明 Qt 软件显示正常，换到命令行工具就乱了
nlohmann::json 报错：
[json.exception.type_error.316] invalid UTF-8 byte at index ...
这些问题都指向一个核心矛盾：
Windows 默认编码（GBK）与程序内部编码（UTF-8）不一致。
本文将从原理、现象、原因、解决方案，带你彻底搞清楚 UTF-8/GBK 混乱的本质，并给出可直接复用的代码模板。
1. 为什么会出现 UTF-8 / GBK 混乱？
1.1 Windows 的默认编码是 GBK（代码页 936）
中国大陆环境中：
cmd / PowerShell 默认编码 = GBK
Windows API（ANSI）默认编码 = GBK
VC++ 编译器默认解析源文件编码 = 当前系统代码页（GBK）
这意味着：
- 你在
.cpp里写"中文"→ 会按 GBK 字节序列存入可执行文件 - 控制台能显示 GBK 文字，但不能显示 UTF-8
- 一旦库要求 UTF-8（如 JSON 库），GBK 字符就成为'非法字节'
导致乱码、报错、无法解析。
1.2 现代开发中的 UTF-8 越来越普及
UTF-8 是现在几乎所有系统的标准编码：
- Linux / macOS 默认 UTF-8
- Qt 的内部字符串
QString→ UTF-16 → 转换到 UTF-8 - JSON 标准要求 UTF-8
- Python/JS/Go/Java 默认 UTF-8
当 UTF-8 文本经过 GBK 控制台输出，就一定乱码。
2. 常见错误案例
2.1 JSON 报错：invalid UTF-8 byte at index
[json.exception.type_error.316] invalid UTF-8 byte at index 3: 0xC4
原因：
- 你的
.cpp文件保存为 GBK - 编译器按 GBK 解析
"中文 (简体)"这样的字符串 - 生成的字符串不是合法 UTF-8，被 JSON 库拒绝
2.2 JSON 中出现多余的 \
例如：
