Qt Test 是 Qt 官方轻量级单元测试框架，原生支持 GUI 自动化测试，需通过代码驱动控件并验证状态，适合与 Qt Widgets 或 Qt Quick 应用深度集成。

Qt Test 是 Qt 官方提供的轻量级单元测试框架，它原生支持 GUI 自动化测试（如模拟点击、输入、窗口切换等），但不是“无界面录制回放”工具，而是通过代码驱动控件、验证状态，适合与 Qt Widgets 或 Qt Quick 应用深度集成。

一、环境准备：启用 Qt Test 并组织测试结构

确保项目使用 qmake 或 CMake 正确链接 Qt5Test（或 Qt6Test）。推荐将测试代码与业务代码分离：

• 在 src/ 下写主程序（含 QApplication 和 UI 类）
• 新建 tests/ 目录，每个测试类对应一个 .h/.cpp 文件
• 测试类继承 QObject，并使用 Q_OBJECT 宏（qmake 需 CONFIG += qtestlib）

二、编写 GUI 测试：核心是 QApplication + 模拟用户操作

GUI 测试必须运行在 QApplication 实例中。关键步骤：

• 在 initTestCase() 中创建被测窗口（如 MyMainWindow w;），调用 w.show()
• 用 QTest::mouseClick()、QTest::keyClicks() 等函数触发交互（注意传入控件指针和坐标/按键）
• 用 QTest::qWait(10) 短暂等待事件处理（避免竞态），再断言控件状态（如 QVERIFY(widget->text() == "OK")）
• 避免直接 sleep；优先用 QSignalSpy 监听信号（如按钮点击后 emit 的 dataSubmitted()）

三、常见难点与绕过技巧

Qt Test 不自动处理模态对话框、多线程 UI、QML 动画等场景：

MergeIQ: Automatically Score & Prioritise PR Complexity for GitLab and GitHub

使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...

下载

立即学习“C++免费学习笔记（深入）”；

• 弹出 QMessageBox？用 QTest::keyClick(Qt::Key_Enter) 或查找子窗口并点击其按钮
• 测试 QML 界面？需搭配 QQuickView + QMetaObject::invokeMethod() 调用 JS 函数，或暴露 C++ 接口供测试调用
• 无法获取私有控件？在 UI 类中加 Q_PROPERTY(QObject* testTarget READ getTestTarget) 或提供 findChild<QPushButton*>("saveBtn")
• 测试启动慢？用 QApplication::setQuitOnLastWindowClosed(false) 避免窗口关闭退出进程

四、运行与集成

编译后生成可执行测试程序，直接运行即可输出 PASS/FAIL 结果：

• 命令行加参数：./mytest -xml -o report.xml 生成 XML 报告
• 配合 CI（如 GitHub Actions）时，确保运行环境有 GUI 支持（Linux 可用 xvfb-run 启动虚拟帧缓冲）
• 不建议用 Qt Test 做跨进程/跨应用测试（如测试 Excel 插件）；这类场景应选 AutoHotKey、pywinauto 或 Squish

基本上就这些。Qt Test 的优势在于紧贴 Qt 生态、零额外依赖、调试友好；劣势是需手写逻辑、不支持图像识别或低层 hook。对纯 Qt 应用来说，它是稳定可控的自动化起点。