g++/clang++环境下wofstream无法写入日文字符的跨平台适配问题

问题根因 #

gcc/clang默认运行时使用C locale，仅支持ASCII字符集，宽字符转多字节字符时遇到日文等非ASCII字符会转换失败，导致文件流进入错误状态，最终没有内容写入文件。

方案1：无需修改代码，仅调整编译+运行参数（优先推荐） #

仅需两步即可让原有wstring+wofstream的代码正常运行：

• 编译时添加gcc参数：g++ 你的源码文件.cpp -fwide-exec-charset=UTF-32 -fexec-charset=UTF-8
• 运行时指定系统内置的通用UTF-8 locale：LC_ALL=C.UTF-8 ./生成的可执行文件

C.UTF-8是所有Linux发行版默认预装的locale，不需要额外安装日文语言包即可正常使用。

方案2：代码修改方案（稳定性更高，不依赖运行环境配置） #

思路A：全平台统一使用UTF-8编码的窄字符接口 #

这是目前跨平台C++开发的通用最佳实践，和你现有Windows下的实现完全兼容：

1. 所有源码统一保存为UTF-8编码
2. Windows MSVC编译时添加/utf-8参数，指定源码和执行字符集为UTF-8
3. Linux下g++/clang++默认使用UTF-8作为执行字符集，无需额外参数

全平台通用示例代码：

#include <fstream>

int main() {
    std::ofstream file("file.txt");
    std::string str = "お姉ちゃん、おはよう！";
    file << str;
    return 0;
}

思路B：保留宽字符接口，手动设置locale #

如果项目已经大量使用wstring/wfstream，不想整体改造，可以在代码入口处全局设置locale即可：

#include <fstream>
#include <locale>

int main() {
    // 全局设置为系统默认locale，Linux下会自动使用环境变量指定的UTF-8 locale
    std::locale::global(std::locale(""));
    std::wofstream file("file.txt");
    std::wstring str = L"お姉ちゃん、おはよう！";
    file << str;
    return 0;
}

该代码在Windows、Linux平台均可正常运行，无需额外编译参数。

内容的提问来源于stack exchange，提问作者Someone