第二篇：VS2019 + Qt5.9.9 中文乱码实战：源码GB2312不乱码、文件写入与跨平台方案

一、GB2312源码不乱码现象分析（VS2019 + Qt5.9.9）

1. 测试环境配置

操作系统：Windows 10/11（中文版）
开发工具：Visual Studio 2019
Qt版本：Qt 5.9.9
源码编码：GB2312/GBK
特殊配置：未添加/utf-8编译选项，未使用#pragma execution_character_set("utf-8")

2. 观察现象

当使用GB2312编码保存源文件并直接写入中文字符串时：

cpp 复制代码

QString str = "中文测试";
ui->label->setText(str);

结果显示正常，UI显示、调试查看均无乱码现象。

3. 与文档描述的差异

Qt5.9.9官方文档明确指出：

QString::QString(const char*)构造函数会使用fromUtf8()函数将输入的const char指针转换为Unicode。

理论上GB2312编码的源码被当作UTF-8解析时应该出现乱码，但实际运行却完全正常。

4. 原因推测

在特定环境组合下（VS2019 + Qt5.9.9 + Windows中文环境 + GB2312源码 + 未设置/utf-8），Qt可能未严格按文档说明使用fromUtf8()，而是自动启用了兼容逻辑，实际使用fromLocal8Bit()（系统本地编码GBK）解析字符串字面量。

不乱码的根本原因是：

复制代码

源码编码(GB2312/GBK) == 系统本地编码(GBK) == Qt实际解析编码(GBK)

三者编码一致，因此显示正常。这是一种未文档化的平台兼容行为，不建议作为可靠的开发方式。

二、文件写入乱码解决方案

1. 测试目标

将QString中的中文正确写入文件（CSV/文本），确保能被Excel、记事本正常打开。

2. 测试结果对比

✅ 使用QTextStream写入：中文显示正常
❌ 直接使用file.write()写入：出现乱码
💡 关键发现：使用QTextStream时，是否添加.toUtf8()效果相同

3. 正确写入方式

cpp 复制代码

QFile file("out.csv");
file.open(QIODevice::WriteOnly | QIODevice::Text);
QTextStream out(&file);
out << str;  // 添加str.toUtf8()效果相同
file.close();

4. QTextStream工作原理

默认使用系统本地编码（GBK）写入文件
自动将Unicode字符转换为GBK字节
Windows软件默认用GBK解码，因此打开正常

5. toUtf8()无效原因

QTextStream会将所有输入内容统一编码为本地编码（GBK）写入文件，无论输入的是QString还是QByteArray。

6. file.write()乱码原因

cpp 复制代码

// 错误写法1：直接写入Unicode内部数据
file.write(str);

// 错误写法2：写入UTF-8字节（Windows默认用GBK打开）
file.write(str.toUtf8());

缺少编码转换步骤，导致字节流与文件解码规则不匹配。

三、跨平台开发编码规范

1. 源码文件规范

保存格式：UTF-8无BOM
VS2019设置：文件 → 高级保存选项 → 选择"UTF-8无签名"

2. 编译器配置

项目属性 → C/C++ → 命令行 → 附加选项添加：

复制代码

/utf-8

3. 编码兼容指令

cpp 复制代码

#if _MSC_VER >= 1600
#pragma execution_character_set("utf-8")
#endif

4. 字符串处理规范

cpp 复制代码

// 推荐写法1：Qt专用，效率最高
QString str = QStringLiteral("中文");

// 推荐写法2：C++标准，跨编译器通用
QString str = u8"中文";

5. 文件写入规范

cpp 复制代码

QFile file("out.csv");
file.open(QIODevice::WriteOnly | QIODevice::Text);
QTextStream out(&file);
out.setCodec("UTF-8");  // 强制使用UTF-8编码
out << str;
file.close();

6. 跨平台开发要点

源码：UTF-8无BOM
编译：添加/utf-8选项
字符串：使用QStringLiteral或u8""前缀
文件：必须设置setCodec("UTF-8")

总结

在特定环境下GB2312源码不乱码是Qt的平台兼容行为，实际使用fromLocal8Bit()解析，不可依赖
QTextStream默认使用系统本地编码写入文件，因此不会乱码
直接使用file.write()会因缺少编码转换而导致乱码
跨平台开发必须统一使用UTF-8编码体系

以上均为本人结合实际运行现象做出的个人猜测，若有清楚底层真实原理的大佬，欢迎在评论区留言指正交流！