Qt 多线程与信号槽机制

在 Qt 中，信号与槽不仅仅用于同线程内的对象通信，更重要的是它支持跨线程通信，这是其区别于许多 GUI 框架的强大特性。

一、为什么要用信号与槽来做线程通信？

直接在线程之间访问对象或变量，容易出现竞态条件和线程安全问题。而信号与槽提供了一种线程安全的通信方式：

• 不需要手动加锁（只要正确连接）

• 保证槽函数在接收者对象所属线程中执行

• 支持同步或异步方式（DirectvsQueued）

二、Qt 线程模型简介

• QThread是 Qt 提供的线程类。

• Qt 中的QObject 默认属于创建它的线程（通常是主线程）。

• 你不能直接在QThread中放业务逻辑，应将逻辑封装为对象（如 Worker 类），并将该对象“移动”到目标线程中。

三、线程中的信号与槽连接类型

在不同线程的对象之间连接信号与槽，默认使用的是：

Qt::QueuedConnection

这意味着：

• 发射信号的线程将信号事件放入接收者线程的事件队列中

• 槽函数在接收者的线程中执行（必须运行事件循环）

四、完整示例：主线程控制 + 工作线程执行 + 信号传回主线程

结构说明

• Worker类：负责在子线程中执行耗时任务

• MainWindow或main()负责创建线程、连接信号与槽、控制流程

🔧 Worker.h

#ifndef WORKER_H #define WORKER_H #include <QObject> #include <QDebug> #include <QThread> class Worker : public QObject { Q_OBJECT public: explicit Worker(QObject *parent = nullptr) {} public slots: void doWork() { qDebug() << "Worker thread ID:" << QThread::currentThreadId(); // 模拟耗时操作 for (int i = 0; i < 5; ++i) { QThread::sleep(1); emit progress(i * 20); } emit finished(); } signals: void progress(int percent); void finished(); }; #endif // WORKER_H

🧩 main.cpp

#include <QCoreApplication> #include <QThread> #include "Worker.h" int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); qDebug() << "Main thread ID:" << QThread::currentThreadId(); QThread* workerThread = new QThread; Worker* worker = new Worker(); // 将 Worker 移动到线程 worker->moveToThread(workerThread); // 启动线程时，调用 doWork QObject::connect(workerThread, &QThread::started, worker, &Worker::doWork); // 工作完成后退出线程 QObject::connect(worker, &Worker::finished, workerThread, &QThread::quit); // 删除线程和对象（安全释放资源） QObject::connect(worker, &Worker::finished, worker, &QObject::deleteLater); QObject::connect(workerThread, &QThread::finished, workerThread, &QObject::deleteLater); // 监听进度（主线程槽函数响应） QObject::connect(worker, &Worker::progress, [](int val){ qDebug() << "Progress:" << val << "% — Thread:" << QThread::currentThreadId(); }); // 启动线程 workerThread->start(); return a.exec(); }

五、输出示例

Main thread ID: 0x78e8 Worker thread ID: 0x78f8 Progress: 0 % — Thread: 0x78f8 Progress: 20 % — Thread: 0x78f8 Progress: 40 % — Thread: 0x78f8 Progress: 60 % — Thread: 0x78f8 Progress: 80 % — Thread: 0x78f8 ...

注意：槽函数在主线程中执行，说明QueuedConnection生效。

六、重点讲解：为什么这样做是正确方式？

七、问题和要点

✅ 总结