C++如何将std::wstring转换为UTF-8编码的string-C++-PHP中文网

c++17起std::wstring_convert已弃用，c++20移除；推荐用iconv或utf8cpp：前者跨平台稳定，后者轻量无依赖但需注意utf-16/utf-32差异；windows可用widechartomultibyte但须处理代理对和嵌入空字符。

c++如何将std::wstring转换为utf-8编码的string

std::wstring转UTF-8：用std::wstring_convert已不可行

在C++17中，std::wstring_convert和std::codecvt_utf8已被弃用，C++20彻底移除。现在硬用会触发编译警告甚至失败，尤其在GCC 11+或Clang 13+上。别找“修复warning”的临时方案——它本身就是设计淘汰的组件。

推荐方案：用std::iconv或第三方轻量库（如utf8cpp）

系统级转换最稳的是iconv，跨平台且无额外依赖；若不想引入C API，utf8cpp（头文件-only）是更现代的选择。两者都绕过标准库废弃机制，也避免Windows平台WideCharToMultiByte的编码页陷阱。

iconv需注意：输入编码指定为"WCHAR_T"（Linux/macOS）或"UCS-4LE"（Windows下std::wstring通常为UTF-16，但Linuxwchar_t是32位，实际是UTF-32）
utf8cpp直接处理std::wstring时，默认按UTF-16解释（Windows行为），需确认源字符串确实是UTF-16 —— MSVC和MinGW默认如此，但Linux GCC的std::wstring是UTF-32，此时要先转成std::u16string再进utf8cpp
性能上，utf8cpp无内存分配开销，iconv有初始化成本但批量转换更快

Windows专用但需谨慎：WideCharToMultiByte(CP_UTF8)

这是Windows SDK原生API，在MSVC项目里最直接。但它隐含两个坑：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

必须传WC_ERR_INVALID_CHARS标志，否则遇到非法代理对（surrogate pair）会静默截断，而非报错
std::wstring长度传给cchWideChar时，若含嵌入L'\0'，该API会提前终止 —— 它按C-style null-terminated处理，不是安全的buffer length
返回值为0时，要用GetLastError()判断是缓冲区不足还是编码错误，不能只靠返回值真假

最简可行示例（utf8cpp + Windows UTF-16路径）

假设你用MSVC或MinGW，std::wstring内容来自GetWindowText或std::to_wstring等常规来源（即UTF-16）：

#include <utf8.h>
#include <string>

std::string wstring_to_utf8(const std::wstring& wstr) {
    std::string out;
    utf8::utf16to8(wstr.begin(), wstr.end(), std::back_inserter(out));
    return out;
}
</string></utf8.h>

注意：utf8::utf16to8内部会检查代理对有效性，遇到非法序列抛utf8::invalid_code_point异常 —— 这比静默失败更可控。如果你不能抛异常，得包一层try/catch并决定fallback策略（比如替换为U+FFFD）。

Linux下若wchar_t是32位，上面代码会把每个wchar_t当UTF-16码点处理，结果错乱。此时必须先转成std::u16string，或改用iconv配"WCHAR_T"编码名。