c++oding="utf-8" ?>
直接用std::wstring_convert会编译失败，因为c++17已将其移除，gcc 9+、clang 10+、msvc 2019等新编译器报“'wstring_convert' is not a member of 'std'”；应改用windows api widechartomultibyte或跨平台utf-8转换逻辑。
直接用std::wstring_convert会编译失败？
因为 C++17 起，std::wstring_convert 和 std::wbuffer_convert 已被标准移除（deprecated 并删除），很多新版本编译器（如 GCC 9+、Clang 10+、MSVC 2019 默认）直接报错：error: 'wstring_convert' is not a member of 'std'。别浪费时间查文档确认是否拼错——它真没了。
替代方案只有两个靠谱方向：系统 API（Windows）或跨平台库（如 ICU、Boost.Locale），但多数简单场景其实只需要 UTF-8 编码的 std::string，这时可借助标准库的 std::codecvt_utf8<wchar_t></wchar_t>（虽也 deprecated，但目前仍可用）或更稳妥的 C++11 原生方式。
Windows 下用 WideCharToMultiByte 最稳
Windows API 提供了明确、可控、零依赖的转换路径，尤其适合只跑 Windows 的项目。关键点不是“能不能转”，而是编码选择和错误处理。
-
CP_UTF8是唯一推荐的CodePage参数，避免用CP_ACP（当前系统 ANSI 页），否则中文在简体中文系统外大概率乱码 - 必须两次调用：第一次传
nullptr获取目标缓冲区长度，第二次才写入；忽略这点会导致缓冲区溢出或截断 - 检查返回值：若函数返回 0，调用
GetLastError()查具体错误，常见是输入含非法 surrogate 对
示例片段：
std::string wstring_to_utf8(const std::wstring& wstr) {
if (wstr.empty()) return {};
int size_needed = WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), nullptr, 0, nullptr, nullptr);
std::string str(size_needed, 0);
WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), &str[0], size_needed, nullptr, nullptr);
return str;
}
Linux/macOS 或跨平台项目怎么处理？
POSIX 系统没有等价的 WideCharToMultiByte，std::codecvt_utf8<wchar_t></wchar_t> 虽在 libstdc++/libc++ 中尚存，但行为不一致（比如 GCC 不支持非 BMP 字符正确转换），且标准已弃用，不建议新代码使用。
真正可靠的做法是引入轻量级转换逻辑，或用现成小工具：
- 手动遍历
wchar_t，对每个字符用std::mbstate_t+std::wcrtomb转 UTF-8 —— 注意状态必须重置，且需处理返回 -1 的错误情况 - 用
iconv（系统自带）：打开"WCHAR_T"→"UTF-8"转换描述符，调用iconv()，兼容性好但略重 - 直接抄一段已验证的 UTF-16/UTF-32 到 UTF-8 转换函数（如 Howard Hinnant 的开源实现），仅几十行，无外部依赖
为什么不能直接 reinterpret_cast 或 memcpy？
因为 std::wstring 在 Windows 是 UTF-16（wchar_t 为 2 字节），Linux/macOS 通常是 UTF-32（wchar_t 为 4 字节），而 std::string 是字节序列，二者内存布局无映射关系。直接强制转换只会得到乱码二进制垃圾，且跨平台必崩。
典型错误现象：std::string s(reinterpret_cast<const char>(wstr.c_str()), wstr.size() * sizeof(wchar_t))</const> —— 这在 Windows 上输出的是 UTF-16LE 的裸字节，Python 读出来就是一堆 \xff\xfe 开头的乱码。
真正要的不是“把宽字符当字节拷”，而是“把 Unicode 码点转成 UTF-8 字节流”。这个语义差异，是绝大多数初学者卡住的根本原因。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
