C++17起std::wstring_convert和std::codecvt_utf8已被弃用，Windows应使用WideCharToMultiByte转UTF-8，跨平台推荐utf8cpp或ICU等第三方库。
宽字符转多字节时，std::wstring_convert 已被弃用，别再用了
从 C++17 开始，std::wstring_convert 和 std::wbuffer_convert 被标记为 deprecated，GCC、Clang、MSVC 都已移除或不推荐使用。强行用会触发编译警告甚至报错，比如：error: 'wstring_convert' is not a member of 'std'。这不是兼容性问题，是标准层面的淘汰——它设计上不支持状态ful编码（如 UTF-8 换行符处理）、异常行为不一致，且无法处理 BOM 和编码探测。
Windows 下用 WideCharToMultiByte 转 UTF-8 最稳
在 Windows 平台，直接调用 Win32 API 是最可靠的方式，尤其要转 UTF-8（而非系统本地 ANSI）时：
// 转成 UTF-8 string
std::string wstring_to_utf8(const std::wstring& wstr) {
if (wstr.empty()) return {};
int size = WideCharToMultiByte(CP_UTF8, 0, wstr.c_str(), -1, nullptr, 0, nullptr, nullptr);
if (size == 0) return {};
std::string str(size, '\0');
WideCharToMultiByte(CP_UTF8, 0, wstr.c_str(), -1, &str[0], size, nullptr, nullptr);
str.pop_back(); // 去掉末尾的 '\0'
return str;
}-
CP_UTF8明确指定目标编码，避免依赖系统 locale - 两次调用：第一次获取缓冲区大小，第二次写入；不能省略第一次，否则可能截断
- 传
-1表示含结尾L'\0'，所以结果带一个额外'\0'，需pop_back() - 如果目标不是 UTF-8（比如要转 GBK），把
CP_UTF8换成CP_ACP或具体代码页，但 UTF-8 才是跨平台安全选择
跨平台方案：用 std::iconv 或第三方库（如 ICU、utf8cpp）
Linux/macOS 没有 WideCharToMultiByte，原生只提供 iconv 接口，C++ 标准库不封装它，必须手动调用：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
// 简化示意（实际需检查返回值、错误码）
iconv_t cd = iconv_open("UTF-8", "WCHAR_T");
size_t inbytes = wstr.size() * sizeof(wchar_t);
char* inbuf = reinterpret_cast<char*>(const_cast<wchar_t*>(wstr.c_str()));
// ... 分配输出缓冲、调用 iconv()、处理截断 ...
iconv_close(cd);-
"WCHAR_T"不是所有系统都支持，glibc 支持，musl 可能不支持；macOS 的iconv对宽字符支持较弱 - 更现实的做法是引入轻量库：比如
utf8cpp（header-only）只处理 UTF-8 ↔ UTF-16，适合std::wstring在 Windows 上是 UTF-16 的场景 - 若项目已用 ICU，优先用
icu::UnicodeString中转，它对编码转换健壮得多
别用 std::codecvt_utf8<wchar_t> —— 它在 C++17 同样被弃用
网上很多教程还教这个，但它和 wstring_convert 是一套，同样被标准废弃。即使编译通过（如旧版 libstdc++），运行时也可能崩溃或乱码，尤其遇到代理对（surrogate pair）时完全没处理逻辑。
立即学习“C++免费学习笔记（深入）”；
- MSVC 早在 2015 Update 3 就禁用了
std::codecvt系列模板 - Clang/libc++ 从 7.0 起彻底移除实现
- 用它写的代码不具备可移植性，也不符合现代 C++ 实践
真正需要跨平台且不引入第三方时，最简方案是：Windows 用 WideCharToMultiByte，其他平台先转 UTF-16 编码的 std::u16string，再用 utf8cpp 转 UTF-8 —— 这比硬啃 iconv 更少出错。宽字符转换从来不是“一行解决”的事，编码边界、BOM、空终止、错误替换策略，每个点都得显式控制。
