跨平台处理UTF-16字符串：兼容WinAPI的可靠类型及方案

一、标准化的跨平台UTF-16类型 #

C++11及以上标准提供的char16_t是跨平台的UTF-16类型，它的大小在所有平台上固定为16位，完全符合UTF-16编码定义。但Windows API的宽字符接口依赖wchar_t（Windows平台下wchar_t为16位，对应UTF-16），因此需要在Windows平台做简单适配。

二、具体移植性保障方法 #

1. 平台适配类型别名

通过预编译宏定义跨平台的UTF-16类型别名，让代码在Windows上直接对接WinAPI，其他平台使用标准char16_t：

#include <cstdint>

#ifdef _WIN32
using utf16_char = wchar_t;
#else
using utf16_char = char16_t;
#endif

// 跨平台UTF-16字符串类型
using utf16_string = std::basic_string<utf16_char>;

Windows环境下utf16_char等价于wchar_t，可直接传入LPCWSTR等WinAPI参数；其他平台则使用标准char16_t，保证编码一致性。

2. 编码转换封装

如果项目内部统一用UTF-8存储字符串（跨平台项目常用实践），只需在调用WinAPI时临时转换为UTF-16（wchar_t），调用完成后再转回UTF-8。可封装通用转换函数：

#ifdef _WIN32
#include <windows.h>

utf16_string utf8_to_utf16(const std::string& utf8_str) {
    if (utf8_str.empty()) return {};
    int len = MultiByteToWideChar(CP_UTF8, 0, utf8_str.c_str(), -1, nullptr, 0);
    utf16_string utf16_str(len - 1, 0);
    MultiByteToWideChar(CP_UTF8, 0, utf8_str.c_str(), -1, utf16_str.data(), len);
    return utf16_str;
}

std::string utf16_to_utf8(const utf16_string& utf16_str) {
    if (utf16_str.empty()) return {};
    int len = WideCharToMultiByte(CP_UTF8, 0, utf16_str.c_str(), -1, nullptr, 0, nullptr, nullptr);
    std::string utf8_str(len - 1, 0);
    WideCharToMultiByte(CP_UTF8, 0, utf16_str.c_str(), -1, utf8_str.data(), len, nullptr, nullptr);
    return utf8_str;
}
#else
// 其他平台用标准库实现转换
#include <codecvt>
#include <locale>

utf16_string utf8_to_utf16(const std::string& utf8_str) {
    std::wstring_convert<std::codecvt_utf8_utf16<char16_t>, char16_t> converter;
    return converter.from_bytes(utf8_str);
}

std::string utf16_to_utf8(const utf16_string& utf16_str) {
    std::wstring_convert<std::codecvt_utf8_utf16<char16_t>, char16_t> converter;
    return converter.to_bytes(utf16_str);
}
#endif

3. 借助成熟跨平台库

避免重复造轮子，直接使用封装好的跨平台字符串处理库：

• ICU：全面支持各种编码转换、字符串操作，是工业级国际化库，完美适配Windows、macOS、Linux。
• fmt库（C++20标准std::format的实现）：支持UTF-8、UTF-16等编码的格式化与转换，接口简洁易用。
• Boost.Locale：提供跨平台本地化与编码处理功能，集成度高。

4. 避免直接跨平台使用wchar_t

除Windows平台调用WinAPI的场景外，不要在跨平台代码中直接使用wchar_t——Linux和macOS下wchar_t为32位（对应UTF-32），与Windows的16位wchar_t完全不兼容，会导致编码混乱或程序崩溃。

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