QT的moveToThread 用法

moveToThread() 是 Qt 中将某个 QObject 对象移交到其他线程运行的关键方法，常用于实现 线程间的对象管理和事件处理分离。

基本作用：

object->moveToThread(otherThread);
表示：把 object 所有的事件（包括槽函数）交由 otherThread 管理，即它的事件循环运行在线程 otherThread 中。

常见用法（标准写法）：

假设你有一个自定义工作类 Worker，你希望它在后台线程中运行：

定义 Worker 类（继承 QObject）

class Worker : public QObject
{
Q_OBJECT
public slots:
void doWork() {
qDebug() << "doWork run in thread:" << QThread::currentThread();
// ... 执行耗时任务
}
};

主线程中创建并启动线程 + 移动对象

Worker* worker = new Worker();
QThread* thread = new QThread();

// 将 worker 移动到新线程
worker->moveToThread(thread);

// 当线程启动后，调用 worker 的槽函数
QObject::connect(thread, &QThread::started, worker, &Worker::doWork);

// 处理线程完成时清理
QObject::connect(worker, &Worker::destroyed, thread, &QThread::quit);
QObject::connect(thread, &QThread::finished, thread, &QThread::deleteLater);

// 启动线程
thread->start();

注意事项（很重要）：

项	说明
❶ moveToThread() 必须在对象构造完成后调用，不能在构造函数内部调用
❷ 被移动的对象不能有父对象（不能设置 setParent()）
❸ 不要直接在线程内访问 GUI 元素（只能在主线程处理 GUI）
❹ 所有槽函数将运行在 thread 的事件循环中（即 QThread::exec()）
❺ 如果槽是直接连接（非 Queued），将忽略线程；用 Qt::QueuedConnection 可保证跨线程调用

示例输出验证：
qDebug() << "Main Thread:" << QThread::currentThread();
在 main() 中输出主线程，在 doWork() 里输出当前线程，可以看到 doWork() 在另一个线程中运行。

常见错误用法：

// 错误设计：QThread 本身不应该执行业务逻辑
class MyThread : public QThread {
void run() override {
worker->doWork();  // ❌ 错误：这会在当前线程执行，而非事件循环中
}
};

正确做法是将工作对象移动到线程，并由 QThread 的事件循环调用槽函数。

推荐结构图：

Main Thread
|
|--> 创建 Worker（QObject）
|--> 创建 QThread
|--> worker->moveToThread(thread)
|--> connect(thread->started, worker->doWork)
|--> thread->start()