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

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

核心理念

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

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。