c++怎么将wstring宽字符串写入文件_wofstream与imbue【详解】-C++-PHP中文网

_wofstream写中文乱码的根本原因是未通过imbue()绑定utf编码转换器，且imbue()必须在open()前调用；c++17起codecvt已弃用，跨平台推荐统一用utf-8加std::ofstream手动转码。

c++怎么将wstring宽字符串写入文件_wofstream与imbue【详解】

写入中文宽字符串时文件乱码，是因为没设locale

直接用 _wofstream 写 std::wstring 到文件，中文基本会变乱码或空内容——这不是编码错了，而是流没绑定能处理 UTF-16/UTF-8 的 codecvt 或现代等效方案。Windows 下默认 locale 是 ".ACP"（系统 ANSI 代码页），根本不认识宽字符的字节序列。

关键点：C++ 标准库的宽流不自动做 Unicode 编码转换，imbue() 是唯一可控入口，但要注意它在 C++17 后已被弃用，实际项目中得区分编译标准和目标平台。

VS2015+ / C++14 项目：可用 std::codecvt_utf8<wchar_t></wchar_t> 配合 imbue()，但仅支持 UTF-8 输出（wstring 被转成 UTF-8 字节写入）
C++17 起：std::codecvt 被标记为 deprecated，MSVC 仍支持，但 GCC/Clang 可能编译失败；推荐改用 std::wstring_convert（也已弃用）或手动转码
Windows 原生需求（如需 UTF-16 LE 文件带 BOM）：绕过 _wofstream，用 std::ofstream + std::wstring_convert 或 WideCharToMultiByte

_wofstream::imbue() 必须在打开文件前调用

这个顺序错误非常隐蔽：一旦 open() 或构造时指定了路径，流内部缓冲区就初始化了，再 imbue() 无效，且不报错。

正确写法只能是：

std::wofstream wofs;
wofs.imbue(std::locale(wofs.getloc(), new std::codecvt_utf8<wchar_t>)); // C++11/14
wofs.open(L"out.txt");</wchar_t>

如果写成：

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

std::wofstream wofs(L"out.txt"); // 此时已 open，imbue 失效
wofs.imbue(...); // ⚠️ 无作用

常见后果：文件看似写入成功，但全是问号、空格或高位字节被截断。

调试技巧：用十六进制编辑器看文件头，UTF-8 应无 BOM；UTF-16 LE 应以 FF FE 开头 —— 如果没看到，大概率 imbue 没生效
Linux/macOS 下 _wofstream 行为更不可靠，建议统一用 std::ofstream + 手动 UTF-8 转换

想写 UTF-16 文件（带 BOM），别依赖 _wofstream

_wofstream 在 Windows 上底层调用的是 CreateFileW，但它不控制文件开头是否写 BOM，也不保证字节序。你写 L"你好"，它可能按本地宽字符格式（通常是 UTF-16 LE）写，但没 BOM，很多编辑器打不开或识别错。

稳妥做法是用窄流 + 显式编码：

std::ofstream ofs("out_utf16.txt", std::ios::binary);
// 写 UTF-16 LE BOM
uint8_t bom[2] = {0xFF, 0xFE};
ofs.write(reinterpret_cast<const char>(bom), 2);

// 手动把 wchar_t[] 转成小端字节
for (wchar_t c : my_wstr) {
    uint8_t bytes[2] = {static_cast<uint8_t>(c & 0xFF), static_cast<uint8_t>((c & 0xFF00) >> 8)};
    ofs.write(reinterpret_cast<const char>(bytes), 2);
}</const></uint8_t></uint8_t></const>

不要用 std::codecvt_utf16：它生成的是无 BOM 的 UTF-16，且 C++17 已移除
若必须用标准库，可先用 std::wstring_convert<:codecvt_utf16>></:codecvt_utf16> 转成 std::u16string，再逐 char16_t 写低字节在前
注意 wchar_t 在 Windows 是 16 位，在 Linux 是 32 位 —— 跨平台项目慎用 _wofstream

替代方案：C++20 std::format + std::ofstream 更可控

如果你能用 C++20，std::format 返回 std::string（UTF-8），配合普通 std::ofstream 完全避开宽流陷阱：

#include <format>
#include <fstream>

std::wstring w = L"Hello 世界";
std::string u8 = std::format("{}", w); // 实际需先转码，std::format 不直接支持 wstring
// 正确做法：用 std::wstring_convert 或平台 API 先转 UTF-8，再 format 或直接 write</fstream></format>

更现实的路径是：用 std::wstring_convert<:codecvt_utf8>></:codecvt_utf8>（C++11–17）或 std::iconv（POSIX）做一次转码，之后全用窄字符流操作。

VS2019+ 默认启用 C++17，codecvt 仍可用但会警告；CI 环境若用 Clang，很可能编译失败
真正稳定的跨平台方案：放弃 _wofstream，统一用 UTF-8 编码的 std::string 存储文本，文件 I/O 全走 std::ofstream
Windows GUI 程序若需读写注册表或 API 接口，wstring 不可避免，但文件落地环节建议转码

BOM、字节序、编译器对宽流的实现差异——这些细节不会报错，但会让文件在另一台机器上彻底打不开。与其花半天调 imbue，不如一开始就决定：文件存 UTF-8 还是 UTF-16，然后选对应路径。