Win32 API字符串类型不兼容问题：跨编译器差异及通用解决办法

现象原因 #

• Visual C++默认开启Unicode字符集，此时WNDCLASS是WNDCLASSW的别名，lpszClassName的类型是LPCWSTR（等价于const wchar_t*）。普通字符串是const char*类型，两者不兼容所以报错；给字符串加L前缀后变成宽字符数组（const wchar_t[]），类型匹配，编译通过。
• GCC/Clang编译Win32程序时，默认用多字节字符集，此时WNDCLASS是WNDCLASSA的别名，lpszClassName的类型是LPCSTR（等价于const char*）。普通字符串类型完全匹配，所以能正常编译；加L前缀后变成宽字符类型，和LPCSTR不兼容，因此报错。

跨编译器兼容代码写法 #

1. 显式指定字符集版本 #

直接使用对应字符集的结构体和API函数，避免宏映射的歧义：

// 多字节字符集版本
WNDCLASSA wcA = {0};
wcA.lpszClassName = "MyWindowClass";
RegisterClassA(&wcA);

// 宽字符（Unicode）版本
WNDCLASSW wcW = {0};
wcW.lpszClassName = L"MyWindowClass";
RegisterClassW(&wcW);

2. 用Windows宏自动适配 #

在代码开头或项目设置中定义UNICODE和_UNICODE宏，让Windows头文件自动切换对应字符集的API和类型，同时用TEXT()或_T()宏包裹字符串：

// 必须在#include <windows.h>之前定义这两个宏
#define UNICODE
#define _UNICODE
#include <windows.h>

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd) {
    WNDCLASS wc = {0};
    wc.lpszClassName = TEXT("MyWindowClass"); // 自动根据字符集切换为普通或宽字符串
    RegisterClass(&wc); // 自动映射为RegisterClassA或RegisterClassW
    // 后续窗口创建等操作同理，用TEXT()包裹字符串
    return 0;
}

3. 统一使用Unicode宽字符（推荐） #

现代Windows开发优先推荐Unicode编码，直接使用宽字符版本的API和字符串，无需依赖宏：

#include <windows.h>

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPWSTR lpCmdLine, int nShowCmd) {
    WNDCLASSW wc = {0};
    wc.lpszClassName = L"MyWindowClass";
    RegisterClassW(&wc);
    // 窗口创建用CreateWindowW，消息框用MessageBoxW，所有字符串都带L前缀
    HWND hwnd = CreateWindowW(L"MyWindowClass", L"兼容窗口", WS_OVERLAPPEDWINDOW,
                              CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,
                              NULL, NULL, hInstance, NULL);
    ShowWindow(hwnd, nShowCmd);
    // 消息循环等后续代码...
    return 0;
}

内容的提问来源于stack exchange，提问作者anathrax