Qt5 → Qt6 教学差异对照表

Qt5 → Qt6 迁移检查清单 ✅

一、环境准备

• 编译器升级到 C++17（GCC ≥ 8, MSVC ≥ 2019, Clang ≥ 10）。

• Qt6 安装完成（推荐 6.5 LTS 或 6.7 以上版本）。

• 项目构建工具迁移：

  • 如果原来用 qmake → 改写为 CMakeLists.txt。
  • 使用 find_package(Qt6 ...) 和 target_link_libraries(... Qt6::Widgets)。

二、模块检查

• Qt Multimedia

  • Qt5 的 QMediaPlayer、QCamera API 在 Qt6 已大幅改动。
  • 检查是否需要改用新的 QMediaCaptureSession、QAudioOutput。

• Qt Web

  • Qt WebKit → 已废弃，迁移到 Qt WebEngine。

• Qt Script

  • 已移除 → 改用 QJSEngine 或 QML。

• Qt XMLPatterns

  • 已移除 → 改用 QXmlStreamReader/Writer 或第三方库。

• Qt Sensors / Bluetooth / Positioning

  • API 位置调整，需要更新头文件和类名。

三、API 兼容性检查

• 正则表达式：

  • 替换所有 QRegExp → QRegularExpression。

• OpenGL：

  • 如果使用 QGLWidget / QOpenGLFunctions，检查兼容性。
  • 考虑改用 RHI 或 QQuick3D。

• 打印/文档：

  • QPrinter、QPrintDialog API 是否需要调整。

• 事件循环：

  • 检查 QEventLoop::exec()、信号槽连接语法，保持现代写法。

四、QML / Qt Quick

• QML 导入模块版本检查：

  • 替换 import QtQuick.Controls 1.x → import QtQuick.Controls 2.x。

• QtQuick Controls 1 已移除，UI 需要用 QtQuick Controls 2 重写。

• 检查是否依赖已废弃的 QML 类型（如 QtWebView 1.x）。

• 测试 QML 性能和内存消耗，确认新引擎兼容。

五、第三方依赖

• 检查所有依赖的第三方 Qt 库，是否有 Qt6 版本。

• 如果库停留在 Qt5：

  • 考虑自己迁移源码。
  • 或寻找替代方案。

六、构建与发布

• 全量重新编译项目（Qt6 与 Qt5 二进制不兼容）。
• 检查打包工具链（windeployqt / macdeployqt / linuxdeployqt 是否已更新到 Qt6 版本）。
• 完整运行测试，确认功能无异常。