C++如何将宽字符wstring转string_C++ codecvt与字符编码转换

答案：C++中wstring转string需进行编码转换，常用std::wstring_convert与codecvt_utf8（C++11-14），但该方法在C++17后被弃用；Windows平台推荐WideCharToMultiByte实现高效转换；现代C++建议使用Boost.Locale或ICU等第三方库以确保兼容性与可维护性。

在C++中将宽字符字符串（wstring）转换为普通字符串（string），本质上是进行字符编码的转换，通常是将UTF-16（Windows上wchar_t的常见编码）或UTF-32转为UTF-8或本地多字节编码（如GBK）。C++标准库提供了std::codecvt相关的facet来实现这类转换，尽管部分功能在C++17后被弃用，但在许多现有项目中仍广泛使用。

使用 std::wstring_convert 与 codecvt_utf8（C++11 到 C++14）

在C++11到C++14中，std::wstring_convert 和 std::codecvt_utf8 是最常用的组合，用于在 wstring 和 string 之间转换UTF-8编码。

示例代码：

#include 
#include 
#include 
#include 

int main() {
    std::wstring wstr = L"Hello 世界"; // 宽字符字符串

    // 创建转换器：从 wide string 转 UTF-8 string
    std::wstring_convert> converter;
    std::string str = converter.to_bytes(wstr);

    std::cout << str << std::endl; // 输出: Hello 世界

    // 反向转换
    std::wstring wstr2 = converter.from_bytes(str);
    return 0;
}

说明：

立即学习“C++免费学习笔记（深入）”；

• std::codecvt_utf8 处理 wchar_t 类型的宽字符到 UTF-8 字节序列的转换。
• std::wstring_convert 是一个便捷类，封装了编码转换逻辑。
• 该方法适用于跨平台场景，只要系统支持 UTF-8。

替代方案：手动使用 codecvt facet（更底层控制）

如果不使用 wstring_convert，可以直接使用 std::codecvt facet 进行转换，这提供更精细的控制。

示例：

JobTap一箭职达

面向大学生群体的智能求职推荐平台

下载

#include 
#include 
#include 

int main() {
    std::wstring wstr = L"测试 Test";

    // 获取本地环境中的 codecvt facet
    std::wstring_convert, wchar_t> conv;
    std::string utf8 = conv.to_bytes(wstr);

    std::wcout << L"原始宽字符串: " << wstr << std::endl;
    std::cout << "UTF-8 编码: " << utf8 << std::endl;

    return 0;
}

Windows 平台专用：WideCharToMultiByte

在 Windows 上，推荐使用 Win32 API WideCharToMultiByte，它更稳定、高效，并且不受 C++标准变更影响。

示例（转换为 UTF-8）：

#include 
#include 
#include 

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;
}

int main() {
    std::wstring wstr = L"Hello 中国";
    std::string utf8 = wstring_to_utf8(wstr);
    std::cout << utf8 << std::endl;
    return 0;
}

优点：

• 不受 C++标准弃用影响。
• 可指定目标编码（如 CP_UTF8、CP_ACP 等）。
• 性能更好，适合高频调用场景。

现代 C++ 推荐做法（C++17 及以后）

由于 wstring_convert 被弃用，现代 C++ 项目建议使用第三方库或平台原生API：

• ICU (International Components for Unicode)：功能强大，支持多种编码和国际化操作。
• Boost.Locale：基于 ICU 封装，使用简单，兼容性好。
• std::u8string / std::u16string：C++20 引入了更多 Unicode 字符串类型，未来趋势是使用 char8_t 等类型明确编码语义。

例如使用 Boost.Locale：

#include 
#include 

int main() {
    std::wstring wstr = L"测试字符串";
    std::string utf8 = boost::locale::conv::to_utf << wstr;
    std::cout << utf8 << std::endl;
    return 0;
}

基本上就这些。根据你的编译器版本和目标平台选择合适的方法。对于新项目，优先考虑 Boost 或平台API；老项目可继续使用 codecvt 相关组件，但需注意迁移计划。