焕德1. Qt与VS2019中文乱码问题概述
在Windows平台使用Qt Creator或Visual Studio 2019进行开发时，中文乱码是困扰开发者的高频问题。这个问题通常表现为以下几种形式：
- 源代码中的中文字符显示为问号或方框
- 程序运行时界面控件的中文文本显示为乱码
- 控制台输出的中文字符无法正常显示
- 从数据库读取的中文内容出现乱码
乱码问题的本质是字符编码不一致导致的。Windows系统默认使用GBK编码（代码页936），而Qt框架内部默认采用UTF-8编码，VS2019的编码设置又存在多种选择。当这三种环境的编码设置不匹配时，就会出现字符转换错误。
注意：即使你在代码中使用了
QString::fromLocal8Bit()等转换函数，如果系统层面的编码设置不正确，仍然可能出现乱码。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境配置与编码基础
2.1 检查系统默认编码
在Windows命令提示符下执行chcp命令可以查看当前代码页：
bash复制chcp
# 输出示例：活动代码页: 936
代码页936对应GBK编码，这是中文Windows的默认设置。如果你的系统显示其他代码页，可能需要额外配置。
2.2 VS2019的编码设置
VS2019默认会根据文件内容自动检测编码，但这种方式有时不可靠。建议强制设置源文件编码：
- 打开VS2019，进入"工具"→"选项"→"文本编辑器"→"文件"
- 在"高级保存选项"中设置"编码"为"Unicode(UTF-8 无签名) - 代码页65001"
- 勾选"自动检测不带签名的UTF-8编码"
2.3 Qt项目的编码设置
在.pro文件中添加以下配置可确保Qt使用正确的编码：
qmake复制# 设置源文件编码为UTF-8
QMAKE_CXXFLAGS += /source-charset:utf-8
# 设置执行字符集为UTF-8
QMAKE_CXXFLAGS += /execution-charset:utf-8
3. 常见乱码场景与解决方案
3.1 源代码中文注释乱码
当打开现有项目时发现中文注释变成乱码，可按以下步骤处理：
- 在VS2019中打开文件
- 点击"文件"→"高级保存选项"
- 选择"U