c++写入UTF-8文件方法 c++如何保存为UTF-8编码-C++-PHP中文网

windows下std::ofstream写utf-8乱码因默认用ansi编码，解决方法是二进制模式+手动写bom（\xef\xbb\xbf）+直接输出u8""字符串的utf-8字节；linux/macos依赖locale是否为utf-8，跨平台最稳方案是统一用二进制流。

c++写入utf-8文件方法 c++如何保存为utf-8编码

Windows下用`std::ofstream`直接写UTF-8会乱码

因为默认情况下，std::ofstream在Windows上使用本地ANSI编码（如GBK），哪怕你把字符串字面量写成u8"你好"，写入文件时仍会被当作字节流原样输出，而记事本等工具看到没有BOM、又没声明编码，大概率按ANSI解析——结果就是乱码。

解决思路不是“转换字符串”，而是“让流知道你要写UTF-8”。关键点：必须用std::codecvt_utf8（C++11–17）或C++20的std::text_encoding（尚未广泛支持），但更实际的做法是绕过locale机制，手动控制字节输出。

Windows平台优先用std::ofstream配合std::ios::binary + 手动写BOM（\xEF\xBB\xBF）+ 原始UTF-8字节
不要依赖imbue()配std::codecvt_utf8：VS2019起已弃用，GCC/Clang对它的实现也不一致，极易崩溃或静默失败
u8"中文"字符串字面量本身是UTF-8编码的const char*，可直接写入二进制流，无需转码

Linux/macOS写UTF-8基本不用额外处理

系统默认locale通常是UTF-8（如en_US.UTF-8），std::ofstream在这种环境下写u8"你好"一般能正确显示。但别掉以轻心：

检查当前locale：运行locale命令，确认LC_CTYPE含UTF-8
即使locale是UTF-8，std::ofstream仍可能因未设置imbue而忽略编码语义——不过多数实现会透传字节，所以“碰巧”能用
跨平台项目里，不能假设Linux一定OK；一旦部署到容器或精简镜像（如alpine），locale可能是C，这时u8""写出来仍是UTF-8字节，但终端或编辑器可能不认

最稳的跨平台写法：二进制模式 + 手动BOM

放弃对std::ostream编码能力的幻想，直接操作字节。这是目前兼容性最好、行为最确定的方式。

C++ Code Review Master

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

下载

示例（写入带BOM的UTF-8文件）：

#include <fstream>
#include <string>

void write_utf8_file(const std::string& path, const std::string& content) {
    std::ofstream f(path, std::ios::binary); // 关键：binary模式
    if (!f) return;

    // 写BOM（可选，但能帮Windows记事本识别编码）
    f.write("\xEF\xBB\xBF", 3);
    f.write(content.c_str(), content.size());
}
// 调用：write_utf8_file("out.txt", u8"Hello 世界");
</string></fstream>

BOM不是必须的，但加了能避免Windows记事本默认用ANSI打开
u8"..."确保字符串字面量是UTF-8编码；若内容来自std::wstring或Windows API（如GetWindowTextW），得先用WideCharToMultiByte(CP_UTF8, ...)转成std::string
不用std::endl，改用"\n"——避免std::endl触发flush且可能引入平台相关换行符干扰

用`fopen` + `setmode`（Windows专属捷径）

如果你只跑Windows，且用MSVC，可以用C标准库搭配_setmode强制stdout/stdin为UTF-8，对文件也适用：

需包含<io.h></io.h>和<fcntl.h></fcntl.h>
打开文件后立即调用_setmode(_fileno(f), _O_U16TEXT)？不行——那是给宽字符用的；要UTF-8，得用_O_U8TEXT（仅MSVC 2015+）
但注意：_O_U8TEXT会让fputws自动转UTF-8，而fputs仍按ANSI；混用容易出错
实际中不如二进制写法清晰，尤其当你要写混合内容（如JSON含转义）时，_O_U8TEXT可能多转一次