std::wstring_convert已弃用，不推荐新项目使用；windows首选multibytetowidechar；posix系统可用std::mbstowcs但需谨慎设置locale；跨平台推荐手动utf-8解码以确保可控性与兼容性。
用 std::wstring_convert 转换（C++11，但已弃用）
这个方案在 C++11 中引入，曾是标准推荐方式，但 C++17 起被标记为 deprecated，编译器（如 GCC 7+、Clang 6+）会报警告，不建议新项目使用。
常见错误现象：wstring_convert 在处理非法 UTF-8 字节序列时可能抛出 std::range_error，且对 BOM 处理不统一；跨平台时 Windows 和 Linux 下默认 locale 行为差异大。
实操建议：
- 仅用于维护旧代码，避免在新工程中引入
- 若必须用，显式指定
std::codecvt_utf8<wchar_t></wchar_t>，不要依赖默认构造 - 务必捕获
std::range_error，不能假设输入总是合法 UTF-8
std::wstring_convert<std::codecvt_utf8<wchar_t>> conv;
try {
std::wstring ws = conv.from_bytes("你好");
} catch (const std::range_error&) {
// 输入含非法 UTF-8
}用 MultiByteToWideChar（Windows 平台首选）
Windows API 提供的原生转换函数，稳定、高效、支持 Code Page 控制，是 Win32 / MSVC 环境下最可靠的选择。
立即学习“C++免费学习笔记（深入）”；
关键点：
- 必须指定正确的 code page：UTF-8 用
CP_UTF8，GBK 用936，不能硬写0或省略 -
MultiByteToWideChar第一次调用传nullptr可获取目标缓冲区大小（含终止L'\0'），第二次才写入 - 返回值为
0表示失败，需用GetLastError()查错，常见错误码：ERROR_INVALID_PARAMETER、ERROR_NO_UNICODE_TRANSLATION
int len = MultiByteToWideChar(CP_UTF8, 0, s.c_str(), -1, nullptr, 0);
if (len == 0) { /* 错误处理 */ }
std::wstring ws(len, L'\0');
MultiByteToWideChar(CP_UTF8, 0, s.c_str(), -1, &ws[0], len);用 std::mbstowcs + setlocale（POSIX 兼容方案）
POSIX 标准函数，在 Linux/macOS 上可用，但严重依赖当前 C locale 设置，容易因环境差异导致转换失败或乱码。
典型陷阱：
-
std::mbstowcs不识别 UTF-8 编码名，需先调用setlocale(LC_ALL, "en_US.UTF-8")或类似 UTF-8 locale - Docker 容器或最小化系统常默认为
Clocale，此时 UTF-8 字符全转成L'?'或截断 - 线程不安全：
setlocale是全局操作，多线程下需加锁或改用std::mbrtowc手动解析
更稳妥的做法是只在启动时一次性设置，并验证：
if (!setlocale(LC_ALL, "en_US.UTF-8") &&
!setlocale(LC_ALL, "zh_CN.UTF-8") &&
!setlocale(LC_ALL, "UTF-8")) {
// locale 不可用，拒绝转换
}
size_t n = mbstowcs(nullptr, s.c_str(), 0);
if (n == static_cast<size_t>(-1)) { /* 转换失败 */ }现代跨平台推荐：手动 UTF-8 解码（轻量、可控、无依赖）
如果只处理 UTF-8 → UTF-16（wchar_t 在 Windows 是 UTF-16，在 Linux 通常是 UTF-32），最干净的方式是自己遍历 UTF-8 字节并构造 wchar_t。无需外部库，逻辑清晰，错误可精确控制。
注意点：
- Windows 下
wchar_t是 16-bit，需处理代理对（surrogate pairs）；Linux/macOS 下通常是 32-bit，直接存 Unicode code point 即可 - 遇到非法字节（如
0xC0单独出现）应明确拒绝或替换为U+FFFD，不要静默跳过 - 性能足够好：现代 CPU 分支预测对 UTF-8 解码很友好，比多数封装层更快
核心逻辑片段（Windows 版本，生成 UTF-16）：
std::wstring utf8_to_wstring(const std::string& s) {
std::wstring out;
out.reserve(s.size()); // 保守估计
for (size_t i = 0; i < s.size(); ) {
uint8_t b0 = s[i];
if (b0 < 0x80) {
out += (wchar_t)b0; i++;
} else if ((b0 & 0xE0) == 0xC0 && i+1 < s.size()) {
uint16_t cp = ((b0 & 0x1F) << 6) | (s[i+1] & 0x3F);
if (cp >= 0x80 && cp <= 0xD7FF) out += (wchar_t)cp;
else if (cp >= 0xE000 && cp <= 0x10FFFF) { /* surrogate pair logic */ }
i += 2;
} else { /* error */ break; }
}
return out;
}Windows 和 Linux 对 wchar_t 的位宽差异是绕不开的坎，选方案前先确认目标平台和预期编码行为——这点比“用哪个函数”更重要。
