0

0

QT 应用程序在 Windows 系统上出现中文乱码

看不見的法師

看不見的法師

发布时间:2025-05-26 10:54:28

|

733人浏览过

|

来源于php中文网

原创

windows 系统上使用 qt 开发应用程序时,可能会遇到中文乱码问题。即使 windows 已经全面转向 unicode 编码,但有时仍会因为编码不匹配而出现乱码。以下是详细的分析和解决方案:

QT 应用程序在 Windows 系统上出现中文乱码

Windows 早期采用多字节编码,的确容易出现乱码问题。随着 Windows 全面转向 Unicode 编码,多语言的支持得到了极大改善,出现中文乱码的问题变得较少。出现乱码问题一般是由于 GBK 编码的文件被当做 utf8 编码打开,或者 utf8 编码的文件被当做 GBK 编码打开。这种情况也多出现在 Linux 和 Windows 之间交换文件。

最近几个月开始使用 QT 开发应用程序,无论是在 Windows 还是 Linux 系统下,没有特别配置,编写出来的应用程序都能很好地显示各种语言。即使在 Linux 系统中选择英语语言设置,也能正常显示中文、日文等。

然而,今天遇到了一个 QT 应用程序在 Windows 下出现中文乱码的问题,令人措手不及。

具体情况是这样的,QT 代码来自他人,别人提供的可执行程序没有中文乱码问题。但是在我这里编译这个 QT 项目,生成的程序却出现了乱码。

首先,我怀疑代码采用了 GBK 之类的编码,但经过逐一检查,发现都是采用 utf8 编码,使用记事本打开和保存时都能正常显示。通常,采用 utf8 编码是一个非常安全的方案,全程使用 utf8 对多语言的支持是最好的。

那么问题是否出在 Windows 特有的 utf8 BOM 上呢?

这里需要提一下,BOM 代表 Byte order mark,即字节序标记,有两个作用:

  1. 说明字符流属于 Unicode 编码,且表明了编码方式。
  2. 说明了字节序:big endian 和 little endian。

一般来说,utf8 不需要 BOM,这是微软搞出来的。由于 Windows 是使用最广泛的操作系统,尽管 Linux 程序员极度抵制 utf8 BOM,但也无法阻止它的存在。

但是在 QT 应用程序的乱码问题上,utf8 BOM 并没有什么关系。是否带 BOM 只是文件头几个字节的差异,要么直接出错,不会引起乱码。

而且这个乱码问题还非常奇怪,在 QT 界面设计器中输入的中文显示正常,但是通过 C++ 代码添加的字符串就有乱码问题。难道是字符串类的问题吗?但我在代码中使用的是 QString,内部就是用的 utf8 编码,即使我强行指定 utf8 编码,问题也没有解决。

这个问题我也咨询过 GPT,GPT 给出的方法是检查源码的编码、编辑器的编码设定、使用 QString 的编码转换方法等,但都没有效果。

中文乱码问题可能只会出现在中文世界,中国程序员碰到的几率会更大,于是我上网搜索,使用“QT 中文乱码”作为关键词,果然找到了很多相关讨论。其中一篇文章提到:

ECTouch移动商城系统
ECTouch移动商城系统

ECTouch是上海商创网络科技有限公司推出的一套基于 PHP 和 MySQL 数据库构建的开源且易于使用的移动商城网店系统!应用于各种服务器平台的高效、快速和易于管理的网店解决方案,采用稳定的MVC框架开发,完美对接ecshop系统与模板堂众多模板,为中小企业提供最佳的移动电商解决方案。ECTouch程序源代码完全无加密。安装时只需将已集成的文件夹放进指定位置,通过浏览器访问一键安装,无需对已有

下载

在 Qt Creator 中使用 MSVC 编译器编译项目时,如果处理不当,容易出现中文字符串乱码问题。例如,程序运行时,LabInfo 显示的汉字就会出现乱码。

void MainWindow::Changed()
{
    QString str="测试";
    ui->LabInfo->setText(str);
}

这是因为 Qt Creator 保存的文件使用的是 UTF-8 编码(是任何平台、任何语言都可以使用的跨平台字符集),MSVC 编译器虽然可以正常编译带 BOM 的 UTF-8 编码的源文件,但生成的可执行文件的编码是 Windows 本地字符集,比如 GBK2312。

也就是在可执行文件中,字符串“测试”是以 GBK2312 编码的,而可执行程序执行到这条语句时,对这个字符串却是以 UTF-8 解码的,这样就会出现乱码。

解决方案之一:

在 pro 文件中添加:

win32:msvc{
    QMAKE_CXXFLAGS += /source-charset:utf-8 /execution-charset:utf-8
}

按照文章提供的方法,很快解决了界面上的中文乱码问题。

不过我还是有点不明白,之前创建 QT 应用程序没有加这个选项,也没有出现问题。为什么这个工程会出问题呢?

继续查问题,我发现,在 QT 应用程序中链接 userlib32,如果不指定上面的编译选项,就会出现乱码问题。看来问题出在链接 Windows 库上面,所以保险的方法就是加上编译选项,强行指定源码和可执行程序都使用 utf8 编码。

最后,还有一点需要注意,如果调用第三方库,在返回字符串的时候,可能不是采用的 utf8,这个时候需要显式转换编码,否则也可能出现乱码。

程序开发中经常会出现莫名其妙的问题,问题虽然小,但如果以前没碰到过,解决起来也挺费时间的,所以在这里记录一下,也许以后还会碰到类似的问题。

另外,解决问题时也不能过度依赖 GPT,这次就是查 GPT,而没想着去网上搜索。

相关专题

更多
视频后缀名都有哪些
视频后缀名都有哪些

视频后缀名都有avi、mpg、mpeg、rm、rmvb、flv、wmv、mov、mkv、ASF、M1V、M2V、MPE、QT、VOB、RA、RMJ、RMS、RAM、等等。更多关于视频后缀名的相关知识,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

3360

2023.10.31

C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

68

2025.08.15

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

43

2025.12.05

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

251

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

206

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1437

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

609

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

547

2024.03.22

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

150

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 6.4万人学习

Git 教程
Git 教程

共21课时 | 2.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号