c++oding="utf-8" ?>
std::codecvt在c++17中被弃用、c++20中移除，因跨平台实现不一致且windows下易崩溃、linux下易乱码；其utf8特化要求ucs-4输入，但windows wchar_t为utf-16，处理代理对时失败。
别用 std::codecvt —— 它在 C++17 中被弃用，C++20 中彻底移除，且各编译器实现不一致，Windows 下常崩，Linux 下常乱码。
为什么 std::codecvt_utf8<wchar_t></wchar_t> 在 Windows 上大概率失败
Windows 的 wstring 默认是 UTF-16（wchar_t 为 2 字节），而 std::codecvt_utf8<wchar_t></wchar_t> 标准要求输入是 UCS-4（即 4 字节宽字符）。GCC/Clang 的 libstdc++ 和 libc++ 基本不实现该特化；MSVC 虽有但行为未完全符合标准，传入含代理对（surrogate pair）的字符串时会直接抛 std::range_error 或静默截断。
- 常见错误现象：
std::runtime_error: codecvt::out: conversion failed或输出空字符串 - 即使“看似成功”，遇到 emoji（如 ?）、中文生僻字（如 ?）等需代理对表示的字符，结果必然损坏
-
std::wstring_convert同样被弃用，且封装了codecvt，一并回避
Windows 下最稳的方案：用 WideCharToMultiByte
这是 Windows API 原生支持 UTF-16 → UTF-8 转换的函数，能正确处理代理对、BOM、无效序列，并可选错误策略。
- 调用前先用
WideCharToMultiByte(CP_UTF8, 0, ...)传nullptr获取目标缓冲区大小（含终止符） - 第二次调用填入实际缓冲区，返回值为字节数（不含
\0），记得手动补\0或用std::string(buf, len) - 错误处理建议：检查返回值是否为 0，再调
GetLastError()，常见值如ERROR_NO_UNICODE_TRANSLATION表示遇到无法映射字符
// 示例：安全转 UTF-8
std::string wstring_to_utf8(const std::wstring& wstr) {
if (wstr.empty()) return {};
int size = WideCharToMultiByte(CP_UTF8, 0, wstr.data(), (int)wstr.size(), nullptr, 0, nullptr, nullptr);
if (size
<h3>跨平台可选方案：用 <code>std::from_chars</code> + <code>std::to_chars</code> 不行，改用轻量库或标准方式</h3>
<p>C++20 的 <code>std::from_chars</code>/<code>std::to_chars</code> 只处理数字，不解决编码转换。真正跨平台应放弃标准库编码设施，转向：</p>
- 手动 UTF-16 → UTF-8 编码逻辑（约 50 行，可控、无依赖，适合嵌入式或极简场景）
- 使用
iconv（Linux/macOS 原生，Windows 需额外链接 libiconv） - 或引入单头库如
utf8cpp（utf8::utf16to8函数直转，已处理代理对） - 注意：
std::filesystem::path的u8string()成员在 C++17+ 可用于路径转 UTF-8，但仅限路径语义，不通用
真正难的不是写几行转换代码，而是意识到：C++ 标准库在宽窄字符串编码转换这件事上，从 C++11 到 C++20 是主动“交白卷”。你得自己握着 Windows API 或 utf8cpp 这样的小刀，而不是指望 codecvt 这把锈住的瑞士军刀。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
