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 ¶meter) {
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。
浙公网安备 33010602011771号