VScode C/C++ 、QT qt5 qt6 中文乱码 控制台输出乱码 UTF-8 GBK2313

这篇博客探讨了在VScode和QT环境下C/C++程序控制台输出中文出现乱码的问题。原因是UTF-8编码与Windows控制台的GBK2313编码不匹配。解决方案包括将文件保存为GBK2313格式或者修改系统区域设置为使用UTF-8。作者建议采用修改系统区域设置的方法,因为它操作简便。详细的操作流程包括进入设置,更改系统区域设置为UTF-8。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

问题:VScode C/C++ 、QT qt5 qt6 中文乱码 控制台输出乱码

原因:在VScode、QTdesigner 编译 C/C++ 时,默认采用的 UTF-8 编码,而 Windows 控制台的编码是国标编码 GBK2313,从而导致中文乱码。

解决:解决方法有如下两种。

1. 可以把文件保存为 GBK2313 格式,
2. 修改控制台的编码格式(操作如下述演示图)

我个人建议采用方法二,一来是操作简单,二来是操作也不复杂。

操作流程:

设置 时间和语言 > 语言和区域 > 管理语言设置 > 更改系统区域设置 > Beta版使用UTF-8

演示图:
第1步 打开设置

安卓如图操作即可

<think>我们正在解决QT 6.2 C++程序编译后汉字出现乱码的问题。根据引用资料,我们可以总结出几种常见的解决方案: 1. 设置源文件编码(VS2015/VS2022高级保存选项) 在Visual Studio中,我们可以通过设置源文件的编码为UTF-8 with BOM来解决乱码问题。虽然VS2022默认没有显示“高级保存选项”,但可以通过自定义菜单添加。 2. 使用tr()函数进行国际化(i18n)支持 在QT中,通常建议使用tr()函数包裹需要显示的字符串,然后通过QT的国际化工具(如lupdate、lrelease)生成翻译文件,并在程序中使用这些翻译文件。 3. 使用QStringLiteral或QLatin1String 在代码中,使用QStringLiteral宏来创建字符串,可以确保字符串以正确的编码方式存储。 4. 设置全局的编码 在程序启动时,设置应用程序的默认编码,例如: QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8")); 但是,在QT5.5之后,QT推荐使用UTF-8编码,并且默认情况下,setCodecForLocale等函数已经被弃用。在QT6中,默认使用UTF-8,因此可能不需要设置,但需要确保源文件是UTF-8编码。 5. 在.pro文件中添加设置 在QT项目的.pro文件中,可以添加以下设置: # 设置源文件和头文件的编码为UTF-8 CODECFORSRC = UTF-8 CODECFORTR = UTF-8 6. 使用资源文件(.qrc) 将字符串放在资源文件中,并以UTF-8编码保存,然后通过资源系统加载。 7. 在运行时加载字体(如引用[5]中OpenCV的putText中文乱码解决方案) 对于特定情况(如OpenCV的putText显示中文),需要加载中文字体文件(如simsun.ttc)来显示中文。 根据用户的问题,我们主要关注QT 6.2 C++程序编译后中文显示乱码,因此我们重点考虑QT程序本身的设置。 步骤: 首先,确保源代码文件以UTF-8编码保存(带BOM或者不带BOM?在Windows下,建议带BOM,因为Windows系统默认使用本地编码,而带BOM的UTF-8可以明确标识编码)。 其次,在代码中,对于所有需要显示的中文字符串,使用tr()函数,例如: label->setText(tr("中文")); 然后,在.pro文件中添加: CODECFORTR = UTF-8 CODECFORSRC = UTF-8 另外,在程序启动时(main函数中),可以尝试设置编码(虽然QT6默认UTF-8,但为了确保): #include <QTextCodec> int main(int argc, char *argv[]) { QApplication a(argc, argv); // 设置应用程序的默认字体,确保能显示中文 QFont font("SimSun"); // 宋体 a.setFont(font); // 或者使用以下方式设置编码(在QT6中,QTextCodec相关功能被移到了核心5兼容模块,需要额外包含,且不推荐使用) // 在QT6中,默认使用UTF-8,所以通常不需要设置编码转换 // 如果使用QTextCodec,需要安装core5compat模块,并在.pro文件中添加QT += core5compat #if QT_VERSION < QT_VERSION_CHECK(6,0,0) QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8")); #else // 在QT6中,建议使用QStringConverter,但通常不需要,因为QString内部就是UTF-16,而QT会自动处理转换 #endif ... } 但是,在QT6中,QTextCodec类已经被移除,因此我们不能再使用setCodecForLocale。在QT6中,默认使用UTF-8,所以只要确保源文件是UTF-8编码,并且使用tr(),同时设置好字体,应该可以解决。 另外,在Windows系统上,还需要注意:如果使用MSVC编译器,它可能会根据源文件的编码(带BOM的UTF-8)正确识别,而如果使用MinGW,则也需要确保源文件是UTF-8。 如果仍然出现乱码,可以尝试将源文件保存为带BOM的UTF-8编码(在Visual Studio中通过高级保存选项设置)。 参考引用[2]中,提到了在VS2022中如何调出高级保存选项: 选择菜单栏的工具->自定义->命令->菜单栏->文件->添加命令->文件->高级保存选项->确定 然后就可以在文件菜单中使用高级保存选项,将文件保存为“Unicode (UTF-8 带签名) - 代码页65001”。 另外,引用[5]中提到了使用freetype库来加载字体以解决OpenCV的putText中文乱码,但这是针对OpenCV的,与QT本身无关。如果QT中控件显示乱码,通常不需要这样做。 总结解决方案: 1. 确保所有源代码文件(.h, .cpp, .ui等)以UTF-8 BOM格式保存(在Windows下)。 2. 在代码中使用tr()包裹中文字符串。 3. 在.pro文件中设置CODECFORSRC和CODECFORTR为UTF-8。 4. 在main函数中设置应用程序的字体为支持中文的字体(如“SimSun”或“Microsoft YaHei”)。 5. 如果使用Visual Studio,确保通过高级保存选项设置编码;如果使用其他编辑器,同样确保编码为UTF-8 BOM。 注意:在跨平台开发时,Linux和macOS默认使用UTF-8,所以通常不需要BOM,但Windows需要。 如果以上方法仍然无效,可以考虑使用国际化(i18n)方法:使用lupdate生成.ts文件,然后用Qt Linguist翻译,最后用lrelease生成.qm文件,并在程序启动时加载翻译文件。 步骤: - 在.pro文件中添加:TRANSLATIONS = myapp_zh_CN.ts - 在代码中所有需要翻译的字符串用tr()包裹 - 运行lupdate myapp.pro 生成.ts文件 -Qt Linguist打开.ts文件,翻译字符串 - 运行lrelease myapp.pro 生成.qm文件 - 在main函数中加载.qm文件: QTranslator translator; translator.load(":/translations/myapp_zh_CN.qm"); a.installTranslator(&translator); 这种方法虽然复杂,但可以彻底解决多语言问题,包括中文乱码。 考虑到用户可能只需要解决中文乱码问题,我们首先推荐简单的方法:设置文件编码和字体。 下面给出一个示例步骤: 步骤1:设置源文件编码(以VS2022为例) 1. 打开VS2022,打开QT项目。 2. 按照引用[2]的方法调出“高级保存选项”。 3. 打开每一个包含中文的源文件,在“文件”菜单中选择“高级保存选项”,选择“Unicode (UTF-8 带签名) - 代码页65001”,然后保存。 步骤2:修改代码 在main函数中设置字体: #include <QApplication> #include <QFont> int main(int argc, char *argv[]) { QApplication a(argc, argv); // 设置字体 QFont font; font.setFamily("Microsoft YaHei"); // 或者使用"SimSun" a.setFont(font); // ... 其他代码 } 步骤3:在.pro文件中添加: CODECFORSRC = UTF-8 CODECFORTR = UTF-8 步骤4:对于所有需要显示中文的字符串,使用tr(),例如: label->setText(tr("这是一个标签")); 步骤5:清理项目,重新构建。 如果问题仍然存在,请检查系统的字体是否支持中文,以及是否安装了中文字体。 另外,如果使用CMake而不是qmake,则需要在CMakeLists.txt中设置: add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>") add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>") 这将在MSVC编译器下使用UTF-8编码。 由于用户使用的是QT 6.2,因此我们按照上述步骤进行。 相关问题: 1. 为什么QT程序在Windows下会出现中文乱码? 2. 如何设置QT应用程序的默认字体? 3. 在QT6中,如何处理多语言国际化? 4. 在Linux和macOS下,QT程序是否也会出现中文乱码?如何解决? 5. 使用qmake和CMake时,设置编码的方式有什么不同?</think>### QT 6.2 C++ 程序中文乱码解决方案 #### 问题原因分析 QT 6.2 中文乱码通常由以下原因导致: 1. **编码不一致**:源文件编码(如 GBK)、编译器编码(MSVC 默认本地编码)和 QT 运行时编码(UTF-8)不匹配[^2][^5] 2. **缺少 BOM 头**:Windows 平台 UTF-8 文件需要 BOM 签名才能被正确识别 3. **未正确使用国际化**:未通过 `tr()` 函数处理字符串 4. **字体缺失**:运行环境缺少中文字体支持 --- ### 解决方案(逐步操作) #### 方法 1:设置源文件编码(推荐) **适用于 Visual Studio 开发环境** 1. 调出高级保存选项菜单: - 工具 → 自定义 → 命令 → 菜单栏 → 文件 - 添加命令 → 文件 → 高级保存选项 → 确定[^2] ```mermaid graph LR A[工具] --> B[自定义] B --> C[命令标签页] C --> D[菜单栏-文件] D --> E[添加命令] E --> F[选择 高级保存选项] ``` 2. 修改文件编码: - 打开源文件 → 文件 → 高级保存选项 - 选择 **Unicode (UTF-8 带签名) - 代码页 65001** - 保存文件并重新编译 #### 方法 2:代码层解决方案 **在 `main.cpp` 中添加全局编码设置** ```cpp #include <QApplication> #include <QTextCodec> int main(int argc, char *argv[]) { QApplication a(argc, argv); // 设置全局编码(QT 5 兼容方案) #if QT_VERSION < QT_VERSION_CHECK(6,0,0) QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8")); #else // QT6 默认 UTF-8,需确保文件带 BOM #endif // 设置默认字体 QFont font("Microsoft YaHei", 9); // 使用微软雅黑 a.setFont(font); ... } ``` #### 方法 3:使用 QT 国际化机制 1. 用 `tr()` 包裹所有中文字符串 ```cpp label->setText(tr("中文文本")); // 正确 // label->setText("中文文本"); // 错误 ``` 2. 在 `.pro` 文件中配置编码: ```ini # 指定源文件编码 CODECFORSRC = UTF-8 # 启用翻译 TRANSLATIONS += zh_CN.ts ``` 3. 生成翻译文件: ```bash lupdate project.pro # 生成 .ts 文件 linguist zh_CN.ts # 用 QT Linguist 翻译 lrelease zh_CN.ts # 生成 .qm 二进制 ``` #### 方法 4:编译器配置(CMake) ```cmake # 强制 MSVC 使用 UTF-8 add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>") add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>") ``` --- ### 验证方案 1. **检查文件编码**: - 用记事本打开源文件 → 另存为 → 查看编码格式 - 确认显示 **UTF-8 with BOM** 2. **运行时检查**: ```cpp qDebug() << "当前编码:" << QTextCodec::codecForLocale()->name(); // 输出应为 "UTF-8" ``` --- ### 常见问题排查 | 现象 | 解决方案 | |------|----------| | 控件显示方框 | 设置字体 `setFont(QFont("SimSun"))` | | 控制台乱码 | 添加 `#pragma execution_character_set("utf-8")` | | 文件读取乱码 | 用 `QTextStream` 并设置编码 | | OpenCV 叠加文字乱码 | 使用 `freetype` 加载中文字体[^5] | > **关键提示**:Windows 平台必须保持 **源码编码**、**编译器编码** 和 **QT 运行时编码** 三者统一为 UTF-8 with BOM[^2][^5]。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值