news 2026/6/10 8:55:02

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Qt 多线程编程: moveToThread 模式讲解

目录

Qt 多线程编程: moveToThread 模式

核心理念

旧做法:继承 QThread

推荐:moveToThread

实现步骤图解

1. 定义 Worker

2. 实例化 QThread

3. 移动对象

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

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/9 22:38:01

三种方式打 Java 可执行 JAR 包,你用对了吗?

三种方式打 Java 可执行 JAR 包,你用对了吗?写完代码只是开始,如何打包成一个“开箱即用”的 JAR 文件,才是交付的关键一步。很多 Java 开发者都遇到过这样的问题: 本地跑得好好的程序,一打包就报错 ClassN…

作者头像 李华
网站建设 2026/6/10 10:56:24

05_C 语言进阶之避坑指南:编译器优化等级 —— 嵌入式开发中被忽略的 “隐形陷阱”

C 语言进阶之避坑指南:编译器优化等级 —— 嵌入式开发中被忽略的 “隐形陷阱” 一、编译器优化等级的 “坑”,你踩过吗? “代码在 O0 调试模式下运行正常,切换到 O2 优化后直接卡死?” “全局变量在优化后被编译器‘吃掉’,中断中修改的值主循环读不到?” “调试时…

作者头像 李华
网站建设 2026/6/10 10:51:58

别把数组当“流水账”:用 Summary Ranges 教你学会“结构化思考”

别把数组当“流水账”:用 Summary Ranges 教你学会“结构化思考” 作者:Echo_Wish 一、引子:我们处理的不是数组,是“信息结构化” 咱们聊一个特别小、但特别有味道的题目:汇总区间(Summary Ranges)。 这个题我第一次看到时,直觉觉得:“不就处理个数组嘛,这能有啥…

作者头像 李华
网站建设 2026/6/10 10:53:14

基础进制转换

m 进制转 n 进制(通用实现)m 进制转 n 进制的核心逻辑是以 10 进制为中间桥梁:先将 m 进制数转为 10 进制,再将 10 进制数转为 n 进制。该方法适配任意合法进制(2 ≤ m,n ≤ 36),兼容数字 字母…

作者头像 李华
网站建设 2026/6/10 10:54:54

node基础

从node文档里抄了一些东西贴出来,省的每次都找好久(node文档的那个目录,我感觉找东西挺费劲的) (ps:为什么node v25版本的文档里找不到path模块,v24版本的文档里找到了!!&#xff01…

作者头像 李华