Qt5.10中一个关于QList的怪异问题

在Qt5.10.1 + V2015环境下,一个使用QList的项目报错,由于缺少QPointF的qHash函数实现。与Qt4.8.4相比,虽然同样报警告,但在Qt5中导致编译错误。问题源自QtGui目录下的QList头文件内容异常,可能为Qt的BUG。将QtGui/QList重命名为QEvent后,程序能正常编译并仅显示警告。

先看一个例子代码,首先是项目文件qhash.pro,只有一行。

SOURCES += main.cpp

然后是程序文件main.cpp,

#include <QList>
#include <QPointF>

class Q_DECL_EXPORT PointList : public QList<QPointF>
{
};

int main(int argc, char *argv[])
{
    return 0;
}

在Qt5.10.1 + V2015的环境下编译,报错:

        error: C2665: “qHash”: 25 个重载中没有一个可以转换所有参数类型 ....

首先一点,这个错误没有问题,qt的源码中确实没有实现关于QPointF的qHash函数。

但是诡异的是,因为刚从Qt4迁移到Qt5的环境中,而同样的程序在Qt4.8.4的环境中是没有错误的,只有一堆警告,

warning: C4661: “QSet<T> QList<T>::toSet(void) const”: 没有为显式模板实例化请求提供适当的定义
with
[    T=QPointF  
]

注: 这里的意思是QList中的toSet函数,返回QSet类型的对象,但实例化QSet时,没有找到QSet的定义。但是因为实际没有使用toSet这个函数,所以只是给出了警告信息。

这是什么原因呢?个人觉得非常奇怪。通过查找Qt的源码发现,在Qt5.10的include目录下,包含了两个QList文件,一个在QtCore目录下,另一个在QtGui的目录下,因为我这个项目文件中没有 Qt -= gui,所以默认是包含了Gui模块,这里的#include指令找到的是QtGui目录下的QList文件,怪异的是,这个文件的内容如下:

#include "qevent.h"

不符合Qt头文件的惯例,而QtCore模块下的文件就是合理的。

#include "qlist.h"
而正式这个不合常理的 QList文件,间接include了QSet类的定义,所以编译的时候就不是警告信息,而是直接给出了错误。


这里猜测是QtGui中的QList文件内容错误,或者这个文件名根本不应该是QList,而应该改名为QEvent。这应该是Qt的一个BUG,在Qt的bug系统中也有相关的问题。

经过验证,把Qt目录下的include/QtGui/QList文件改名未QEvent,上面的程序编译没有错误,和4.8环境一样给出了一组警告信息。


Qt 5.10 中导入已有项目时失败,可能由多个因素导致,包括项目配置不兼容、编译器版本不一致、依赖库缺失或路径设置错误等。以下是一些常见问题的解决方法,并结合站内引用内容进行说明: ### ### 检查 `.pro` 文件是否完整且兼容 如果项目原本使用的是更高版本的 Qt(如 Qt 6),其 `.pro` 文件中可能会包含 Qt 5 不支持的模块或类名。例如,在 Qt 6 中 `QVector` 是 `QList` 的别名,而 Qt 5 中两者是独立实现的容器类,若代码中使用了 Qt 6 特有的结构或类型定义,则会导致 Qt 5 编译失败[^2]。 建议检查 `.pro` 文件中的模块声明,确保只使用 Qt 5.10 支持的模块,例如将: ```qmake QT += core gui widgets ``` 而不是引入 Qt 5 不支持的模块。 ### ### 解决 SIP 和 PyQt5 的 API 版本冲突问题 如果项目中涉及 PyQt5 并使用了 QtWebEngineWidgets,需要安装额外的 `PyQtWebEngine` 包。然而,有时会出现 `sip` 模块与 PyQt5 的 API 版本不兼容的情况,提示“the sip module implements API v12.0 to v12.6 but the PyQt5.QtWidgets requires API v12.8”[^1]。 解决方案是升级 `sip` 到与 PyQt5 兼容的版本: ```bash pip install --upgrade sip ``` 或者指定安装特定版本: ```bash pip install sip==4.19.25 ``` 确保安装的 PyQt5 和 SIP 版本相互兼容。 ### ### 处理中文编码问题 如果项目中包含中文字符,更换编译器后可能出现乱码或编译错误,例如“常亮中存在换行符”或“汉字输出乱码”。这是由于不同编译器对源文件编码格式的默认处理方式不同。 可以在字符串前使用 `QString::fromLocal8Bit()` 来显式转换本地编码: ```cpp ui->label->setText(QString::fromLocal8Bit("没有识别到摄像头设备,或没安装驱动")); ``` 同时确保所有源文件保存为 UTF-8 编码格式[^3]。 ### ### 清理缓存并重新加载项目 有时旧项目的构建缓存可能导致导入失败。可以尝试删除项目目录下的 `Makefile`、`moc_*.cpp` 等自动生成文件,以及 Qt Creator 的缓存目录(通常位于用户目录下的 `.qtc` 或项目目录下的 `.qmake.stash` 文件)。 关闭 Qt Creator,删除相关缓存后重新打开项目。 ### ### 检查编译器和调试器配置 Qt 5.10 可能使用的编译器与原项目不一致,例如从 MinGW 切换到 MSVC,或反之。应确认当前选择的 Kit 是否匹配项目所需的编译器类型和版本。 点击左下角的 Kit 选择器,查看所选编译器是否正确,并确保调试器也已正确配置。 ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值