C++ 宽窄字符转换与 Windows 控制台输出乱码解决方法

前言

Microsoft Visual Studio 是 C/C++ 开发的常用工具。深入使用 Windows API 时，会发现大多数接口分为窄字节版（如 MessageboxA）和宽字节版（如 MessageBoxW）。这是因为 Windows 内部广泛采用宽字节处理字符串。尽管在使用窄字节时系统会在底层自动转换，但这种隐式转换增加了开销，因此直接使用宽字节往往更高效。此外，wchar_t 能够支持多国语言，而 char 通常仅受限于本地代码页。

一、什么是宽字节?什么是窄字节?

理解宽窄字符最直接的方式是观察其在内存中的表现：

最直观的区别在于大小：char 占用 1 个字节，而 wchar_t 占用 2 个字节。在代码层面，定义宽字符字符串需要在字符串前添加 L 前缀。

二、宽窄字节之间的转化方法

第1步：利用 Windows API 进行转化

适用于需要精确控制缓冲区分配的场景。核心头文件为 <Windows.h>。

窄转宽：使用 MultiByteToWideChar 函数：

int MultiByteToWideChar(
    UINT CodePage,          // 如 CP_ACP (当前系统ANSI代码页)
    DWORD dwFlags,
    LPCCH lpMultiByteStr,   // 源窄字符串指针
    int cbMultiByte,        // 源串长度(以字节计)，-1表示计算到'
0'为止
    LPWSTR lpWideCharStr,   // 目标宽字符串缓冲区
    int cchWideChar         // 目标缓冲区最大容量
);

宽转窄：使用 WideCharToMultiByte 函数：

int WideCharToMultiByte(
    UINT CodePage,
    DWORD dwFlags,
    LPCWCH lpWideCharStr,   // 源宽字符串指针
    int cchWideChar,        // 源串长度(以字符计)
    LPSTR lpMultiByteStr,   // 目标窄字符串缓冲区
    int cbMultiByte,        // 目标缓冲区最大容量
    LPCCH lpDefaultChar,    // 默认替换字符，通常为 NULL
    LPBOOL pfUsedDefaultChar
);

若不确定缓冲区所需大小，可先调用该函数将目标参数设为 NULL 获取所需空间大小，再进行正式转换。以下为封装后的便捷函数：

// 窄字节转宽字节，返回新分配的内存，需使用者负责 delete[]
wchar_t* AtoW(const char* str, int* len = NULL) {
    int wcLen = MultiByteToWideChar(CP_ACP, 0, str, -1, NULL, 0);
    wchar_t* newBuf = new wchar_t[wcLen + 1]{};
    MultiByteToWideChar(CP_ACP, 0, str, -1, newBuf, wcLen);
    if (len != NULL) *len = wcLen;
    return newBuf;
}

// 宽字节转窄字节
char* WtoA(const wchar_t* str, int* len = NULL) {
    int cLen = WideCharToMultiByte(CP_ACP, 0, str, -1, NULL, 0, 0, NULL);
    char* newBuf = new char[cLen + 1]{};
    WideCharToMultiByte(CP_ACP, 0, str, -1, newBuf, cLen, 0, NULL);
    if (len != NULL) *len = cLen;
    return newBuf;
}

第2步：利用 C/C++ 标准库函数

使用标准 C 库函数，适用于跨平台场景。需注意部分函数在处理非 ASCII 字符（如中文）时需先设置 Locale 环境。

基础函数：

// 窄转宽
size_t mbstowcs(wchar_t* _Dest, const char* _Source, size_t _MaxCount);
// 宽转窄
size_t wcstombs(char* _Dest, const wchar_t* _Source, size_t _MaxCount);

安全版本（推荐）：

errno_t mbstowcs_s(size_t* pReturnValue, wchar_t* dest, size_t sizeInWords, const char* src, size_t maxCount);
errno_t wcstombs_s(size_t* pReturnValue, char* dest, size_t sizeInWords, const wchar_t* src, size_t maxCount);

使用示例：若涉及多语言，务必在程序开头调用 setlocale。

#define _CRT_SECURE_NO_WARNINGS
#include <iostream>
#include <cstdlib>
#include <locale>
using namespace std;
int main() {
    setlocale(LC_ALL, ""); // 启用本地化
    wchar_t buf[256];
    mbstowcs(buf, "你好", 256); 
    return 0;
}

第3步：利用 ATL 库进行快速转换

如果是在 Visual Studio 环境下且依赖 ATL 组件，可以使用 atlconv.h 中的宏进行栈内转换，无需手动管理内存。

#include <iostream>
#include <atlconv.h>
#include <locale>
using namespace std;

int main() {
    setlocale(LC_ALL, "");
    USES_CONVERSION; // 声明上下文

    // 窄转宽 (自动转换为 wstring 或直接指向堆/栈内存)
    char buf[] = "Hello";
    wchar_t* pW = A2W(buf);
    wcout << pW;

    // 宽转窄
    wchar_t wbuf[] = L"Test";
    char* pA = W2A(wbuf);
    cout << pA << endl;
    return 0;
}

注意：虽然 ATL 转换看起来简便，但由于其依赖全局状态，在高并发或复杂场景中可能引发潜在隐患。且该宏生成的宽字串指针在某些重载下并不完全安全，生产环境中更建议优先使用 C++ 的 wstring 配合上述 API 转换。

三. 解决 VS 控制台无法输出宽字符问题

Windows 控制台默认为 ANSI 编码，直接通过 cout << L"..." 通常会导致乱码。以下是三种解决方案：

1. 使用 setlocale 配合 printf

#include <cstdio>
#include <locale>
int main() {
    setlocale(LC_ALL, "");
    printf("%ls", L"了解"); // %ls 用于打印 wide string
    return 0;
}

2. 使用 setlocale 配合 wcout

#include <iostream>
#include <locale>
using namespace std;
int main() {
    setlocale(LC_ALL, "");
    wcout << L"哈哈哈哈啊";
    return 0;
}

3. 使用 WriteConsoleW 绕过流处理

直接使用 Win32 API 写入控制台缓冲区，完全不经过标准的 iostream 重定向逻辑：

#include <Windows.h>
int main() {
    wchar_t buf[] = L"直接输出测试";
    DWORD written = 0;
    HANDLE hStdout = GetStdHandle(STD_OUTPUT_HANDLE);
    WriteConsoleW(hStdout, buf, wcslen(buf), &written, NULL);
    return 0;
}

以上就是 C/C++ 宽窄字符转换与控制台输出处理的详细内容，更多关于 C++ 底层编码机制的资料请关注本站其它相关文章！