Qt 事件系统与多线程（QEvent、QThread、QEventLoop）详解

在 GUI 应用程序设计中，保持主界面流畅响应是用户体验的核心要求。在主线程中执行耗时操作（如大文件读写、网络 IO、复杂计算）会导致事件循环停滞，界面冻结卡死。

本文全面剖析 Qt 的事件系统（QEvent 传递链与事件过滤器）、事件循环机制（QEventLoop），以及 QThread、QtConcurrent 这三种多线程异步处理手段。

---

1. Qt 事件系统机制 (QEvent Delivery Chain)

在 Qt 中，“事件（QEvent）”与“信号槽（Signal & Slot）”是不同的概念：

• 信号槽：通常用于对象间解耦的高级通知机制。
• 事件：Qt 框架底层由操作系统消息转换成的系统级通知（如 QMouseEvent、QKeyEvent、QPaintEvent），通过事件传递链逐层处理。

1.1 事件过滤与拦截

通过重写 QObject::eventFilter()，可以在事件到达目标控件前进行截获：

// 1. 安装事件过滤器
targetWidget->installEventFilter(this);

// 2. 实现过滤逻辑
bool MyWindow::eventFilter(QObject *watched, QEvent *event) {
    if (watched == targetWidget && event->type() == QEvent::MouseButtonPress) {
        // 截获鼠标按下事件，返回 true 表示处理完毕，不再继续向下分发
        return true; 
    }
    return QObject::eventFilter(watched, event); // 其余事件放行
}

---

2. 事件循环与 UI 线程阻塞

Qt 主程序通过执行 a.exec() 开启主事件循环：

QApplication a(argc, argv);
return a.exec(); // 开启主事件循环

a.exec() 本质是一个循环死队列，不断获取系统消息并分发。

2.1 processEvents 的风险

在主线程的长循环中手动调用 QCoreApplication::processEvents() 强制刷新界面容易带来重入风险（Reentrancy），即用户再次点击界面按钮触发重复逻辑。正式项目工程中应优先选择多线程剥离耗时任务。

---

3. QThread 的两种正统用法

3.1 方法一：Worker 对象 + moveToThread（官方推荐）

将业务逻辑封装在独立的 QObject 类中，利用 moveToThread 将其移入新线程。

// 1. 创建 Worker 与 QThread
Worker *worker = new Worker();
QThread *thread = new QThread();

// 2. 更改线程依附性
worker->moveToThread(thread);

// 3. 绑定线程启动信号与业务槽函数
QObject::connect(thread, &QThread::started, worker, &Worker::doWork);

// 4. 业务完成后退出线程并清理内存
QObject::connect(worker, &Worker::workFinished, thread, &QThread::quit);
QObject::connect(thread, &QThread::finished, worker, &QObject::deleteLater);
QObject::connect(thread, &QThread::finished, thread, &QObject::deleteLater);

thread->start();

3.2 方法二：继承 QThread 并重写 run()

适用于无需事件循环的简单后台任务计算。注意：QThread 对象本身身处主线程，只有 run() 函数内部的代码才运行在新线程中。

---

4. 局部嵌套事件循环 QEventLoop

在同步等待某些异步操作完成（如等待网络请求返回）且不想卡死 UI 时，可使用 QEventLoop 创建局部的事件循环：

QEventLoop loop;
QNetworkReply *reply = manager.get(request);

// 异步请求完成后退出局部事件循环
QObject::connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit);

loop.exec(); // 阻塞当前代码往下走，但维持 UI 界面刷新响应

---

5. 高级并发框架 QtConcurrent

对于批量的并行数据计算（如 MapReduce 模式），使用 QtConcurrent 无需显式管理线程与信号槽：

QFuture<void> future = QtConcurrent::run([]() {
    // 在线程池（QThreadPool）中自动调度的后台任务
    do_heavy_computation();
});

---

6. 总结

1. 事件层级：从 QApplication::notify() 到 eventFilter()、event()，最后落到 mousePressEvent() 等虚函数，事件拦截由上至下递进。
2. 多线程建模：后台耗时任务首选 moveToThread 模式或 QtConcurrent 线程池；避免使用 processEvents() 混淆渲染逻辑。
3. 局部等待：QEventLoop 可以在保持界面不卡顿的前提下，将异步流程转化为同步代码风格。