Qt 多线程编程: moveToThread 模式讲解

目录

[Qt 多线程编程: moveToThread 模式](#Qt 多线程编程: moveToThread 模式)

核心理念

[旧做法:继承 QThread](#旧做法:继承 QThread)

推荐:moveToThread

实现步骤图解

[1. 定义 Worker](#1. 定义 Worker)

[2. 实例化 QThread](#2. 实例化 QThread)

[3. 移动对象](#3. 移动对象)

[4. 连接与启动](#4. 连接与启动)

最佳实践与常见陷阱


Qt 多线程编程: moveToThread 模式

这是 Qt 官方推荐的 "Worker-Object" 多线程实现方式。告别错误的 QThread 继承法,掌握真正的事件驱动多线程模型。

核心理念

为什么选择 Worker-Object 模式?

很多人误以为 QThread 本身就是线程。其实,QThread 只是线程的管理者。

旧做法:继承 QThread

直接重写 run() 函数。这种做法使得只有 run 函数内部的代码在子线程运行,而类中的槽函数(Slot)依然在主线程运行,极易导致线程安全问题。

推荐:moveToThread

创建一个继承自 QObject 的 Worker 类,实例化后使用 obj->moveToThread(thread) 移动它。这样该对象的所有槽函数都会自动在子线程中执行。

实现步骤图解

1. 定义 Worker

创建一个继承 QObject 的类,把耗时任务写在槽函数里。

2. 实例化 QThread

创建一个普通的 QThread 对象,不需要继承它。

3. 移动对象

调用 worker->moveToThread(thread)。

4. 连接与启动

连接信号槽,然后调用 thread->start()。

最佳实践与常见陷阱

陷阱:在 Worker 的构造函数中创建对象

千万不要这样做。 如果在 Worker 构造函数里 new QTimer 或其他 QObject,这些子对象会属于创建 Worker 的线程(通常是主线程)。当你调用 moveToThread 时,虽然 Worker 移动了,但它的子对象可能不会正确移动(如果它们已经设置了父子关系,会一起移动;但如果没有父子关系,就会留在主线程)。

最佳实践: 在 Worker 的 start() 或 init() 槽函数中分配资源,该槽函数在线程启动后通过信号触发执行。

内存管理:如何优雅退出?

线程结束后需要清理 QThread 对象和 Worker 对象。推荐的连接方式是:

  • connect(worker, &Worker::finished, thread, &QThread::quit); // 工人干完活,告诉线程退出循环
  • connect(worker, &Worker::finished, worker, &Worker::deleteLater); // 工人干完活,销毁自己
  • connect(thread, &QThread::finished, thread, &QThread::deleteLater); // 线程退出后,销毁线程对象

QtConcurrent vs QThreadexpand_more

并不是所有多线程都需要 moveToThread。

  • QtConcurrent::run: 适合 "用完即走" 的一次性计算任务,不需要事件循环,不需要长期驻留。
  • moveToThread: 适合需要长期运行、处理多个信号、需要事件循环(Event Loop)的服务型任务(如串口通信、TCP服务器、硬件轮询)。

注意点:

  • quit() 只是请求线程事件循环退出;

  • wait() 会阻塞等到线程真的结束。

  • 如果 wait() 返回了 (没超时、没卡住),那说明线程已经结束了,QThread::finished 一定已经在结束过程中发出过。

  • 但这个 if 代码块"执行结束"并不等于一定会结束:如果线程里有阻塞/死循环,wait() 可能一直卡住,代码块就不会结束,也谈不上发 finished。

相关推荐
叼烟扛炮37 分钟前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
严肃小白兔1 小时前
PHP 8.6 正式发布:部分函数应用、原生 I/O 轮询与新特性实战解析
开发语言·php
郝学胜-神的一滴1 小时前
Effective Python 条款36:优雅拼装迭代器与生成器
开发语言·数据结构·人工智能·python·numpy·scikit-learn
文丑颜不良啊1 小时前
LeetCode3401~3420题目解析
java·leetcode
wuyk5553 小时前
Python办公自动化-第04讲-批量新建Excel
开发语言·python·excel
文丑颜不良啊3 小时前
LeetCode3421~3440题目解析
java·leetcode
code2cat4 小时前
【随笔】Java客户端选了HTTP/3,怎样知道请求实际走了哪个版本
java·开发语言·http
码云社区5 小时前
Java在线租房系统源码:VR看房素材、房源图片与内容维护方案
java·vue.js·vr·租房小程序·在线租房·看房租房
码云社区5 小时前
Spring Boot智慧物业系统源码:合同到期提醒、续签资料与资产协作
java·spring boot·后端·物业管理·物业系统·智慧物业
AI开源软件6 小时前
Vue3+SpringBoot3 业务配置统一管理:接管、保存与回退怎样保留有效值
java·前端·vue.js·spring boot·vue·ruoyi office