代码改变世界

QThread多线程

2026-10-30 15:54  一只老老老菜鸟  阅读(11)  评论(0)    收藏  举报

qt中使用QThread创建多线程有两种方式:

1.通过工作对象调用 QObject::moveToThread 移动到线程(推荐)

 创建QThread 对象和继承QObject的Worker 对象,(对象的线程亲和性默认在创建其的线程);调用worker->moveToThread(&workerThread)后,Worker 对象的线程亲和性转移到新线程。

你可以在任意线程中用任意对象的任意信号通过信号槽queued connections连接,线程启动后,Worker 对象的slot槽函数都会在新线程执行。

特别注意:直接调用Worker 对象的slot槽函数不是在新线程执行,而是在调用线程。

代码示例:

class Worker : public QObject
{
Q_OBJECT

public slots:
void doWork(const QString &parameter) {
QString result;
/* ... here is the expensive or blocking operation ... */
emit resultReady(result);
}

signals:
void resultReady(const QString &result);
};

class Controller : public QObject
{
Q_OBJECT
QThread workerThread;
public:
Controller() {
Worker *worker = new Worker;
worker->moveToThread(&workerThread);
connect(&workerThread, &QThread::finished, worker, &QObject::deleteLater);
connect(this, &Controller::operate, worker, &Worker::doWork);
connect(worker, &Worker::resultReady, this, &Controller::handleResults);
workerThread.start();
}
~Controller() {
workerThread.quit();
workerThread.wait();
}
public slots:
void handleResults(const QString &);
signals:
void operate(const QString &);
};

 

2.继承QThread,重写run方法

实现一个WorkerThread 对象继承QThread,然后重写run方法,线程启动后,默认自动调用run,run函数是在新线程中执行,run结束,线程退出,此线程默认没有事件循环和队列,除非调用exec()

特别注意:WorkerThread 实例线程亲和性是在创建他的旧线程,而不是在调用run的新线程。这意味着WorkerThread中所以排队的slot槽函数以及invoked methods方法都在旧线程执行,因此,若你希望slot槽函数都在新线程执行,应该使用moveToThread方法。

特别注意:WorkerThread 的构造函数是在旧线程执行,run是在新线程执行。如二者都有访问同一变量,需注意多线程访问同一变量问题。

代码示例:

class WorkerThread : public QThread
{
Q_OBJECT
public:
explicit WorkerThread(QObject *parent = nullptr) : QThread(parent) { }
protected:
void run() override {
QString result;
/* ... here is the expensive or blocking operation ... */
emit resultReady(result);
}
signals:
void resultReady(const QString &s);
};

void MyObject::startWorkInAThread()
{
WorkerThread *workerThread = new WorkerThread(this);
connect(workerThread, &WorkerThread::resultReady, this, &MyObject::handleResults);
connect(workerThread, &WorkerThread::finished, workerThread, &QObject::deleteLater);
workerThread->start();
}

 

怎么选?简单判断规则

1. 优先 `moveToThread`:
需要和 UI 交互、随时接收指令、多次执行任务、需要信号槽异步回调、上报进度。
2. 选重写 `run()`:
单纯一次性大计算、持续采集循环,**不需要响应外部信号**,简单粗暴跑到底。

 

高频坑点(必看)

坑 1:run 子类里,槽不在子线程

很多人踩这个大坑,以为槽会跑到子线程,不会。

坑 2:moveToThread 后,Worker 不能有父对象

如果 QObject 有 parent,moveToThread 会失败!Qt 不允许带父对象移动线程。qt规定父子对象必须在同一线程。故QObject 有子对象,会随QObject 一起移动到新线程。

 

常见报错1:

QObject::moveToThread: Current thread (0x29f4fbf8d0) is not the object's thread (0x21aaba01170).
Cannot move to target thread (0x29f4fbf8d0)

原因:调用worker->moveToThread(&workerThread)时,当前线程不是worker所属线程。qt规定:调用moveToThread时,当前线程必须是worker所属线程。

 

常见报错2:

ASSERT failure in QCoreApplication::sendEvent: "Cannot send events to objects owned by a different thread. Current thread 0x0x2107e0d7fa0. Receiver '' (of type 'Worker') was created in thread 0x0xfa2acffbb0", file C:\Users\qt\work\qt\qtbase\src\corelib\kernel\qcoreapplication.cpp, line 541

引发:worker中有子对象,然后没有写这行代码connect(&workerThread, &QThread::finished, worker, &QObject::deleteLater);,没有在新线程结束前销毁worker。

原因:在旧线程中调用销毁worker,销毁前会先销毁子对象,销毁子对象前会发事件先断开父子关系,发事件的当前线程和父对象所属线程不是同一个线程,违反qt规定。切勿忘记在线程结束时销毁worker。

 

引用:qt官网文档