在 Windows 控制台中正确显示 UTF-8 字符

使用传统方法在 Windows 控制台中显示 UTF-8 字符的许多尝试均失败正确渲染扩展字符。

失败的尝试：

使用 MultiByteToWideChar() 和 wprintf() 的一种常见方法被证明是无效的，只留下 ASCII 字符可见。此外，使用 SetConsoleOutputCP() 将控制台输出代码页设置为 CP_UTF8 并直接使用 ASCII 字符写入仍然会导致字符损坏。

成功方法：

最终，三种方法证明成功：

1. 直接使用控制台 API：
   直接使用 WriteConsoleW() 函数可以将 Unicode 数据写入控制台，无需转换。
2. 设置文件描述符模式：
   将标准输出文件描述符的模式设置为 _O_U16TEXT 或 _O_U8TEXT 会改变宽字符输出函数的行为，使它们能够正确处理 Unicode 数据。
3. 实现自定义 Streambuf：
   可以通过实现自定义 Streambuf 子类来规避 CRT 函数的限制，该子类可以正确管理到 wchar_t 的转换，并考虑到多字节字符传输的分段性质。

CP_UTF8 失败的原因：

CP_UTF8 的根本问题是由于控制台没有充当接受字节流的典型文件。相反，控制台 API 以离散单位处理数据，导致在单独调用中传输时多字节字符被错误解释。