Qt项⽬升级到Qt6吐⾎经验总结
Qt的版本发布越来越频繁，Qt6发布已经有⼀段时间了，越来越多的⼈咨询之前的代码是否可以增加对Qt6的⽀持，包括开源的项⽬QWidgetDemo（⼀年时间超过2.6K star），近期百忙之中，对所有项⽬进⾏了Qt6的兼容升级，⾃此所有项⽬从Qt4兼容到了Qt6，耗时⼀个多⽉，总计更新调整代码⾏数⼀万多⾏。虽然更新⼯作量不是很⼤，但还是废了九⽜⼆虎之⼒，毕竟项⽬数太多，光⼏⼗个项⽬作品中的其中之⼀⾃定义控件就188个⼦项⽬，为了⽅便⾃⼰也为了总结分享经验，特意整理了从Qt4兼容到Qt6的⼀些经验要点，只是部分，后期持续更新，也欢迎各位留⾔补充。
直观总结
1. 增加了很多轮⼦，同时原有模块拆分的也更细致，估计为了⽅便拓展个管理。
2. 把⼀些过度封装的东西移除了（⽐如同样的功能有多个函数），保证了只有⼀个函数执⾏该功能。
3. 把⼀些Qt5中兼容Qt4的⽅法废弃了，必须⽤Qt5中对应的新的函数。
4. 跟随时代脚步，增加了不少新特性以满⾜⽇益增长的客户需求。
5. 对某些模块和类型及处理进⾏了⾰命性的重写，运⾏效率提⾼不少。
6. 有参数类型的变化，⽐如 long * 到 qintptr * 等，更加适应后续的拓展以及同时对32 64位不同系统的兼容。
7. 源码中的double数据类型全部换成了qreal，和Qt内部数据类型⾼度⼀致和统⼀。
8. 我测试的都是QWidget部分，quick部分没有测试，估计quick部分更新可能会更多。
9. 强烈建议暂时不要⽤Qt6.0到Qt6.2之间的版本，⼀些模块还缺失，相对来说BUG也⽐较多，推荐6.2版本开始正式迁移。
经验总结
1. 万能⽅法：安装5.15版本，定位到报错的函数，切换到源码头⽂件，可以看到对应提⽰字样 QT_DEPRECATED_X("U
sizeInBytes") 和新函数。按照这个提⽰类修改就没错，⼀些函数是从Qt5.7 5.9 5.10等版本新增加的，可能你的项⽬还⽤的Qt4的⽅法，但是Qt6以前都兼容这些旧⽅法，到了Qt6就彻底需要⽤新⽅法了。
2. Qt6对core这个核⼼类进⾏了拆分，多出来core5compat，因此你需要在pro增加对应的模块已经代码中引⼊对应的头⽂件。
//pro⽂件引⼊模块
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
greaterThan(QT_MAJOR_VERSION, 5): QT += core5compat
qq靓号
//代码中引⼊头⽂件
#if (QT_VERSION >= QT_VERSION_CHECK(5,0,0))
#include <QtWidgets>
#endif
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
#include <QtCore5Compat>
#endif
3. 默认Qt6开启了⾼分屏⽀持，界⾯会变得很⼤，甚⾄字体发虚，很多⼈会不习惯，因为这种模式如果程序很多坐标计算没有采⽤
devicePixelRatio进⾏运算的话，100%会出现奇奇怪怪的问题，因为坐标不准确了。要取消这种效果可以设置⾼分屏缩放因⼦。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
QGuiApplication::tHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::Floor);
#endif
4. 原有的随机数函数提⽰⽤QRandomGenerator替代，为了兼容所有qt版本，改动最⼩的办法是直接⽤c++中的随机数，⽐如qsrand函数
换成srand，qrand函数换成rand，查看过源代码，其实封装的就是c++中的随机数，很多类似的封装⽐如qSin封装的sin。
5. QColor的 light 改成 lighter ，dark 改成 darker，其实 lighter、darker 这两个⽅法以前⼀直有。
6. QFontMetricsF 中的 fm.width 换成 fm.horizontalAdvance ，从5.11开始⽤新函数。
7. QPalette调⾊板枚举值，Foreground = WindowText, Background = Window，其中 Foreground 和 Background 没有了，要⽤
WindowText 和 Window 替代，以前就有。类似的还有 tTextColor 改成了 tForeground 。
8. QWheelEvent的 delta() 改成 angleDelta().y()，pos() 改成 position() 。
9. svg模块拆分出来了svgwidgets，如果⽤到了该模块则需要在pro增加 QT += svgwidgets 。
10. qlayout中的 margin() 函数换成 contentsMargins().left()，查看源码得知以前的 margin() 返回的就是 contentsMargins().left()，在四个数
值⼀样的时候，默认四个数值就是⼀样。类似的还有tMargin移除了，统统⽤tContentsMargins。
11. 之前 QChar c = 0xf105 全部要改成强制转换 QChar c = (QChar)0xf105，不再有隐式转换，不然编译报错提⽰error: conversion from
'int' to 'QChar' is ambiguous 。
12. qSort等⼀些函数⽤回c++的 std::sort 。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
std::sort(ipv4s.begin(), d());
#el
qSort(ipv4s);
#endif
13. Qt::WA_NoBackground 改成 Qt::WA_OpaquePaintEvent 。
14. QMatrix 类废弃了没有了，换成 QTransform ，函数功能基本⼀致，QTransform 类在Qt4就⼀直有。
15. QTime 计时去掉了，需要改成 QElapdTimer ，QElapdTimer 类在Qt4就⼀直有。
16. QApplication::desktop()废弃了，换成了 QApplication::primaryScreen()。
#if (QT_VERSION > QT_VERSION_CHECK(5,0,0))
#include "qscreen.h"
#define deskGeometry qApp->primaryScreen()->geometry()
#define deskGeometry2 qApp->primaryScreen()->availableGeometry()
#el
#include "qdesktopwidget.h"
#define deskGeometry qApp->desktop()->geometry()
#define deskGeometry2 qApp->desktop()->availableGeometry()
#endif
17. 获取当前屏幕索引以及尺⼨需要分别处理。
//获取当前屏幕索引
int QUIHelper::getScreenIndex()
{
//需要对多个屏幕进⾏处理
int screenIndex = 0;
#if (QT_VERSION >= QT_VERSION_CHECK(5,0,0))
int screenCount = qApp->screens().count();
王者水晶
关于饺子的传说#el
int screenCount = qApp->desktop()->screenCount();
#endif
if (screenCount > 1) {
//找到当前⿏标所在屏幕
QPoint pos = QCursor::pos();
for (int i = 0; i < screenCount; ++i) {
#if (QT_VERSION >= QT_VERSION_CHECK(5,0,0))
if (qApp->screens().at(i)->geometry().contains(pos)) {
#el
if (qApp->desktop()->screenGeometry(i).contains(pos)) {
#endif
screenIndex = i;今天的月亮很美
break;
}
}
}
return screenIndex;
}
//获取当前屏幕尺⼨区域
QRect QUIHelper::getScreenRect(bool available)
{
QRect rect;
int screenIndex = QUIHelper::getScreenIndex();
if (available) {
#if (QT_VERSION >= QT_VERSION_CHECK(5,0,0))
rect = qApp->screens().at(screenIndex)->availableGeometry();
#el
rect = qApp->desktop()->availableGeometry(screenIndex);
#endif
} el {凉拌核桃肉
#if (QT_VERSION >= QT_VERSION_CHECK(5,0,0))
rect = qApp->screens().at(screenIndex)->geometry();
#el
rect = qApp->desktop()->screenGeometry(screenIndex);
#endif
}
return rect;
}
18. QRegExp类移到了core5compat模块，需要主动引⼊头⽂件 #include 。
成熟男人的头像19. QWheelEvent构造参数和对应的计算⽅位函数变了。
//模拟⿏标滚轮
#if (QT_VERSION < QT_VERSION_CHECK(6,0,0))
QWheelEvent wheelEvent(QPoint(0, 0), -scal, Qt::LeftButton, Qt::NoModifier);
#el
QWheelEvent wheelEvent(QPointF(0, 0), QPointF(0, 0), QPoint(0, 0), QPoint(0, -scal), Qt::LeftButton, Qt::NoModifier, Qt::ScrollBegin, fal); #endif
QApplication::ndEvent(widget, &wheelEvent);
//⿏标滚轮直接修改值
QWheelEvent *whellEvent = (QWheelEvent *)event;
//滚动的⾓度,*8就是⿏标滚动的距离
#if (QT_VERSION < QT_VERSION_CHECK(6,0,0))
int degrees = whellEvent->delta() / 8;
#el
int degrees = whellEvent->angleDelta().x() / 8;
#endif
//滚动的步数,*15就是⿏标滚动的⾓度
int steps = degrees / 15;
20. qVariantValue 改成 qvariant_cast ，qVariantSetValue(v, value) 改成了 v.tValue(val)。相当于退回到最原始的⽅法，查看
qVariantValue源码封装的就是qvariant_cast。
21. QStyleOption的init改成了initFrom。
22. QVariant::Type 换成了 QMetaType::Type ，本⾝以前的 QVariant::Type 封装的就是 QMetaType::Type 。完美的近义词
23. QStyleOptionViewItemV2 V3 V4 之类的全部没有了，暂时可以⽤ QStyleOptionViewItem 替代。
24. QFont的 resolve 的⼀个重载函数换成了 resolveMask。
25. QSettings的 tIniCodec ⽅法移除了，默认就是utf8，不需要设置。
26. qcombobox 的 activated(QString) 和 currentIndexChanged(QString) 信号删除了，⽤int索引参数的那个，然后⾃⼰通过索引获取值。
个⼈觉得这个没必要删除。
27. qtscript模块彻底没有了，尽管从Qt5时代的后期版本就提⽰为废弃模块，⼀致坚持到Qt6才正式废弃，各种json数据解析全部换成qjson
类解析。
28. QByteArray 的 append indexOf lastIndexOf 等众多⽅法的QString参数重载函数废弃了，要直接传 QByteArray，就在原来参数基础上
加上 .toUtf8() 。查看源码也看得到以前的QString参数也是转成.toUtf8()再去⽐较。
29. QDateTime的时间转换函数 toTime_t + tTime_t 名字改了，对应改成了 toSecsSinceEpoch + tSecsSinceEpoch ，这两个⽅法在
Qt5.8时候新增加的。
30. QLabel的 pixmap 函数之前是指针 *pixmap() 现在换成了引⽤ pixmap()。
31. QTableWidget的 sortByColumn ⽅法移除了默认升序的⽅法，必须要填⼊第⼆个参数表⽰升序还是降序。
32. qtnetwork中的错误信号error换成了errorOccurred。
方便面面饼33. XmlPatterns模块⽊有了，全部⽤xml模块重新解析。
34. nativeEvent的参数类型变了。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
bool nativeEvent(const QByteArray &eventType, void *message, qintptr *result);
#el
bool nativeEvent(const QByteArray &eventType, void *message, long *result);
#endif
