彻底解决QT5 中文编译不过问题

最新推荐文章于 2024-09-27 21:15:54 发布
原创 最新推荐文章于 2024-09-27 21:15:54 发布 · 1.2k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#windows 10 #qt5

在Windows平台使用Qt5开发时，由于默认仅支持UTF-8编码，当源码中包含中文时会导致编译失败。解决方法包括在代码中设置编码为UTF-8-BOM，或者使用编辑器如Notepad++将源文件另存为UTF-8-BOM格式。这两种方法都能有效解决中文字符编译错误。

在windows平台使用Qt5开发时，会出现源码（.cpp或者qml）中包含中文，导致编译不通过，具体的错误代码见下图：
在这里插入图片描述

原因分析

出现错误的原因是windows下，QT默认只使用“UTF-8”的编码方式，而中文字体需要“UTF-8-BOM”格式。

解决方法

方法1：（最简单）
在类的构造函数中添加上面两行代码，可以解决该类中包含中文编译不过的问题。

QTextCodec *codec = QTextCodec::codecForName("UTF-8-BOM");
QTextCodec::setCodecForLocale(codec
最低0.47元/天 解锁文章
彻底解决QT+MSVC编译器中文乱码报错问题
小米的修行之路
12-31 800
解决qt中文乱码问题
Qt开发中彻底解决中文乱码问题
qq_53832058的博客
01-08 2981
中文乱码问题主要源于编码不一致需要同时设置控制台和Qt应用程序的编码确保项目文件和环境配置的编码一致文件操作时注意指定正确的编码。
QT5编辑中文字符编译报错问题解决办法
无与才哥的专栏
02-17 4286
最近开始学习QT编程，发现还蛮好用的。就是中文字符的问题把我搞得头很大，一旦代码里面有中文字符，编译就会报错，于是乎到处找解决办法，无奈QT的资源好像有些少，幸得最终找到一个帖子，最后解决了，记录下。 帖子链接：http://bbs.qter.org/forum.php?mod=viewthread&tid=2296 用的是5.3.2，我的设置： Qt Creator环境设置：默认编码：UT
关于QT5下代码中文字符编译不通过的问题
qq_39836658的博客
11-07 1103
分两步： （1）解决编译问题 菜单栏 工具->选项->文本编译器->行为->文件编码选择UTF-8，下面UTF-8 BOM处下拉菜单选择 如果是编码是UTF-8则添加。 （2）解决乱码问题 在程序源文件开始出添加  #pragma execution_character_set("utf-8") 分两步： （1）解决编译问题 菜单栏 工具->选项->文本编译器->行为->文件编码选
qt5这个为什么编译错误呢
qq_27253649的博客
12-04 285
QT解决中文编译不通过问题
chc_office的博客
11-17 2774
一、环境配置 win10 64位系统、VS2013环境、QT5.6.2版本、QT Creator软件 我使用QT Creator进行程序的编译运行。 二、问题提出 我在使用QT Creator进行程序编译运行时，如果字符串的类型是英文则没有问题，但是如果是中文，则会报 C2001:常量中有换行符 的错误。 三、错误原因 （1）在QT中，默认的编码是Unicode，我们书写的代码文件被强制转换为utf8，但是，在简体中文版的Windows操作系统中，默认编码却是GBK。 （2）因此，在QT编译程序时，如果代码
Qt中解决编译中文乱码和编译失败的问题
pingis58的博客
08-12 697
编译时只要CPP中有中文，都会无法识别报错。设置编辑器UTF-8编码，并且保存BOM头。将含有中文的CPP文件修改，点保存就能解决，QT 原minGW切换到MSVC后，QString赋值常量字符串，显示乱码解决办法。
精选资源
彻底解决QT5.5以上版本中文输入的问题
06-22
本人亲测，主要针对的系统是ubuntu14.04和16.04，QT5.5版本以上，想自己编译的可按照http://www.cnblogs.com/cposture/p/5397694.html进行编译，不想编译的直接下载我编译好的就行 本人亲测，主要针对的系统是...
解决Qt 5 代码中中文编译错误和中文乱码问题
anhuizhj的专栏
02-15 2304
1、解决编译错误问题 菜单栏“工具(T)→选项(O)...→文本编辑器→行为→文件编码”，“默认编码:”选择“UTF-8”，“UTF-8 BOM:”选择“如果编码是UTF-8则添加”。 2、解决中文乱码问题 在程序源文件中添加代码： #pragma execution_character_set("utf-8")  ...
qt编译中文不过
weixin_46648511的博客
09-04 246
2.解决办法可以选择重新编码:菜单编辑->select encoding。1.遇到qt编译中文不过，主要是因为qt不太好支持中文。4.但是最后还是发现qt不太友好支持中文。3.或者用Textcodec做转换。
QT5解决MSVC编译中文错误
余浩的博客
07-26 516
QT5解决MSVC编译中文错误错误现象解决方法 错误现象 解决方法 在.pro文件添加代码 msvc:QMAKE_CXXFLAGS += -execution-charset:utf-8 msvc:QMAKE_CXXFLAGS += -source-charset:utf-8 QMAKE_CXXFLAGS_WARN_ON += -wd4819
qt5解决中文编译错误问题
weixin_34310785的博客
05-19 471
2019独角兽企业重金招聘Python工程师标准>>> ...
【如何解决Qt5中使用中文导致编译不过的问题】
weixin_45660690的博客
07-06 851
Qt代码中使用中文导致编译不过的问题解决方式
QT5 不能输入中文，中文编译不过，显示不正常的解决方法
KiranRao的博客
12-05 913
else if (tmp == QStringLiteral("4 AC模式全呼叫C")) 可以使用QStringLiteral 函数， 函数返回的也是QString 类型，
Linux Mint （应用软件：QT 5.X编译错误）
talk_8的专栏
06-19 9637
我们在前面介绍了如何安装QT，安装完后可以使用它编写QT程序。使用QT编写程序还是一如既往的好用，不过在编译QT程序的时候遇到了编译错误。当我们编译写好的QT应用程序时，提示“cannot find -lGL”。
qt中不能使用中文问题
lovehere33的专栏
07-02 2037
问题： 安装了QTcreator但是在qtcreator中不能使用中文，并且在Ubuntu下中文可以正常使用： 可能原因及解决办法： 1.输入法切换快捷键与qt的相关快捷键冲突： 在QT Creater->Tools->Options... 里找到environment->Keyboard，发现TextEditor.CompleteThis 命令，其快捷键是Ctrl+Space ； 再后面添加Al
windows下Qt使用fopen函数无法打开中文名文件
u011983700的专栏
06-30 3169
有个功能需要实现win下Qt将文件上传到服务器，文件有可能会带有中文，在linux下Qt编写测试demo时没有遇到任何问题，能顺利使用fopen打开中文文件，但是将代码移植到win下后发现使用fopen打开中文文件一直失败，参考了如下资料终于解决了问题：资料链接bool UTF8ToUnicode(const char* UTF8, wchar_t* strUnicode) { DWORD...
解决QT开发由于中文导致的编译错误以及输出内容乱码问题
LWD的博客
09-27 1257
解决QT中文乱码所导致的问题
QT 6.2 C++程序编译后汉字出现乱码如何解决？
最新发布
07-16
<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]。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值