Qt 中文乱码的根源：QString::fromLocal8Bit 和 fromUtf8 区别在哪？
在 Qt 开发中，只要项目一涉及中文、文件、日志、网络或 Win32 API，就几乎绕不开一个问题：
为什么同一段代码，在自己电脑上显示正常，换一台机器就出现乱码？
绝大多数情况下，问题并不在 Qt，而是出在字符串编码的理解上。 尤其是下面这两个函数：
QString::fromLocal8Bit() QString::fromUtf8()它们看起来非常相似，但语义完全不同。这篇文章将系统性地讲清楚它们的区别、联系，以及在实际项目中的正确使用方式。
一、先给结论
这两个函数做的事情本质是一样的：
将某种编码的字节序列，转换为 Qt 内部使用的 UTF-16 格式的 QString。
真正的区别只有一个：
Qt 用什么编码规则来解释这些字节。
接口 | 假定输入字节的编码 |
|---|---|
fromLocal8Bit | 当前操作系统的本地编码 |
fromUtf8 | UTF-8 编码 |
二、QString 内部使用什么编码？
QString 内部统一使用 UTF-16 存储字符。
因此，所有fromXXX()接口的作用，都是把外部的字节数据，按照指定的编码规则转换为 UTF-16。
编码用错，转换结果必然错误，中文乱码只是最直观的表现。
三、Local8Bit 中的 “Local” 到底指什么？
1. 本地编码并不是固定的
“Local” 指的是当前操作系统的默认代码页，而不是某一种确定的编码。
常见情况如下：
Windows 简体中文系统：GBK / CP936
Windows 英文系统：CP1252
Linux / macOS：通常是 UTF-8
这意味着，同一段代码在不同系统环境中，fromLocal8Bit的行为可能完全不同。
2. fromLocal8Bit 的真实含义
QString s = QString::fromLocal8Bit(bytes);这行代码等价于：
这些字节是用当前系统默认编码保存的，请按该编码规则进行解析。
它的行为依赖运行环境，而不是代码本身。
四、fromUtf8 的特点
QString s = QString::fromUtf8(bytes);它的语义非常明确：
这些字节一定是 UTF-8 编码，与操作系统、区域设置无关。
这也是为什么在现代 Qt 项目中，fromUtf8是最推荐、最安全的选择。
网络协议、JSON、配置文件、Qt 资源文件，几乎全部都以 UTF-8 作为标准编码。
五、实际项目中该如何选择？
推荐使用 fromUtf8 的场景
网络通信数据
JSON、XML、配置文件
Qt 资源文件（qrc）
UTF-8 编码的数据库字段
Qt 5 及之后版本的源码字符串
QString s = QString::fromUtf8(data);这是跨平台项目的默认选择。
只能使用 fromLocal8Bit 的场景
Win32 API 返回的
char*明确标注为本地编码的第三方库接口
老项目遗留的 GBK 文本文件
QString s = QString::fromLocal8Bit(win32CharPtr);这种使用更多是为了兼容历史环境，而不是推荐做法。
六、最常见的乱码来源
1. 用 fromUtf8 解析 GBK 数据
GBK 和 UTF-8 是完全不同的编码体系，用错接口必然乱码。
2. Windows 下用 fromLocal8Bit 解析 UTF-8 字符串
例如：
QString s = QString::fromLocal8Bit(u8"中文");u8 字符串是 UTF-8，而 Windows 的本地编码通常是 GBK，解析结果必然错误。
3. 代码在不同机器上行为不一致
只要使用了fromLocal8Bit，就意味着结果依赖系统环境。
七、QString 字面量的一个关键细节
在 Qt 5 及之后：
QString s = "中文";默认按 UTF-8 处理，等价于：
QString s = QString::fromUtf8("中文");而在 Qt 4 或更早的项目中，这一点并不成立，也是很多老项目乱码的根源。
八、对比总结
对比项 | fromLocal8Bit | fromUtf8 |
|---|---|---|
是否依赖系统 | 是 | 否 |
跨平台一致性 | 差 | 极好 |
是否适合新项目 | 不适合 | 强烈推荐 |
Windows 下稳定性 | 低 | 高 |
九、最后的经验总结
如果你清楚知道数据的来源编码，就使用对应的接口。 如果你不确定编码来源，优先选择 UTF-8。
这是避免 Qt 中文乱码最可靠的一条原则。