在 Windows 上解决 std::cout 输出 UTF-8 字符串乱码问题，彻底掌握！

2024-03-04 02:19:12

## 在 Windows 上解决 std::cout 输出 UTF-8 字符串的乱码问题

在跨平台 C++ 应用程序中，使用 std::cout 输出 UTF-8 字符串在 Windows 系统上可能出现乱码问题。本文旨在介绍问题原因并提供解决方案，让开发者能够正确在 Windows 上以 UTF-8 格式打印字符串。

问题原因

std::cout 在 Unix 系统上默认将 8 位字符串解释为 UTF-8，而 Windows 上默认为非 Unicode 格式（如 Latin-1）。这导致 8 位 UTF-8 字符串在 Windows 控制台上显示乱码。

解决方法

要解决此问题，需要在 Windows 上显式将控制台输出代码页和输出字符集设置为 UTF-8：

#include <windows.h>

int main() {
    // 设置控制台输出代码页为 UTF-8
    SetConsoleOutputCP(65001);
    SetConsoleOutputChcp(65001);

    std::string test = u8"Greek: αβγδ; German: Übergrößenträger";
    std::cout << test;

    return 0;
}

SetConsoleOutputCP(65001); 设置控制台输出代码页为 UTF-8。
SetConsoleOutputChcp(65001); 设置控制台输出字符集为 UTF-8。

通过设置这两个函数，Windows 将正确解释 std::cout 输出的 8 位字符串为 UTF-8。

常见问题解答

1. 为什么需要设置代码页和字符集？

代码页指定字符集，而字符集指定如何将字符映射到二进制值。在 Windows 上，控制台默认使用不同的代码页和字符集，需要显式设置为 UTF-8。

2. 其他解决方法是什么？

WideCharToMultiByte() 和 MultiByteToWideChar() 函数：在 Unicode 和 8 位字符串之间进行转换，但需要更多代码和处理。
Unicode 控制台： 创建 Unicode 控制台窗口并使用 std::wcout 输出，但需要更多的配置和处理。

3. 如何在 IDE 中使用 UTF-8 编码？

确保你的 IDE 已配置为使用 UTF-8 编码。在 Visual Studio 中，可以转到“文件”>“高级保存选项”>“编码”>“使用 Unicode UTF-8”。

4. 为什么 _setmode() 导致断言错误？

_setmode() 在 Visual C++ 中用于设置文件模式，但它不支持 UTF-8 输出。使用 SetConsoleOutputCP() 和 SetConsoleOutputChcp() 专门为控制台输出指定 UTF-8。

5. 如何处理多语言环境？

如果应用程序在多种语言环境中运行，可能需要使用 WideCharToMultiByte() 和 MultiByteToWideChar() 函数在 Unicode 和 8 位字符串之间进行转换。