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 动画等场景：
立即学习“C++免费学习笔记（深入）”；
- 弹出
QMessageBox？用QTest::keyClick(Qt::Key_Enter)或查找子窗口并点击其按钮 - 测试 QML 界面？需搭配
QQuickView+QMetaObject::invokeMethod()调用 JS 函数，或暴露 C++ 接口供测试调用 - 无法获取私有控件？在 UI 类中加
Q_PROPERTY(QObject* testTarget READ getTestTarget)或提供findChild("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 应用来说，它是稳定可控的自动化起点。
