📚 课程目录第4章跨线程信号槽

4. 跨线程信号槽

跨线程信号槽，说白了就是让不同线程里的对象能互相通信。嗯，这听起来简单，但实际坑不少。我最早接触Qt时，以为信号槽就是随便connect一下完事，结果程序动不动就崩溃。后来才明白，连接方式选不对，线程安全就是一句空话。

4.1 两种连接模式的核心区别

Qt提供了两种跨线程连接方式：Qt::DirectConnection和Qt::QueuedConnection。它们的行为完全不同，我建议你先把这张图看明白。

你看，红色箭头是DirectConnection，绿色箭头是QueuedConnection。一个直接跑，一个排队等。我刚开始用的时候，总觉得QueuedConnection慢，后来才发现，慢是为了安全。

4.2 Qt::DirectConnection：直接调用

DirectConnection的行为，说白了就是：信号一发射，槽函数立刻在当前线程执行。不管接收者在哪个线程，槽函数都在发送者线程里跑。

⚠️ 注意： 如果发送者和接收者不在同一个线程，DirectConnection会导致槽函数在发送者线程执行。这时候如果槽函数访问了接收者的成员变量，就存在线程安全问题。

举个例子，我在项目中遇到过这样一个场景：主线程里有个工作对象，子线程发射信号通知它更新UI。如果用DirectConnection，槽函数就在子线程里执行，直接操作UI控件——嗯，Qt会直接崩溃给你看。因为UI操作必须在主线程。

// 错误示范：跨线程DirectConnection操作UI
connect(workerThread, &Worker::dataReady,
        uiObject, &UIWidget::updateDisplay,
        Qt::DirectConnection);  // ❌ 槽函数在子线程执行，操作UI会崩溃

4.3 Qt::QueuedConnection：排队调用

QueuedConnection就聪明多了。它会把信号调用包装成一个事件，扔到接收者线程的事件循环里排队。接收者线程空闲时，再从队列里取出执行。

这样做的好处很明显：槽函数永远在接收者线程执行，天然线程安全。你想想看，只要你不共享可变数据，每个线程各管各的，就不会有竞态条件。

<code>// 正确做法：跨线程通信用QueuedConnection
connect(workerThread, &Worker::dataReady,
        uiObject, &UIWidget::updateDisplay,
        Qt::QueuedConnection);  // ✅ 槽函数在主线程执行，安全操作UI

💡 小技巧： 其实Qt的默认连接方式会自动判断。如果发送者和接收者在同一个线程，就用DirectConnection；否则用QueuedConnection。但我个人习惯显式指定，这样代码意图更清晰。

4.4 跨线程通信的线程安全性

说到线程安全，很多人以为用了QueuedConnection就万事大吉。其实不然。QueuedConnection只保证了槽函数在正确的线程执行，但如果你在信号里传递了指针或引用，那还是会有问题。

我曾经踩过一个坑：子线程通过信号传递了一个QList<int>的引用给主线程。结果主线程还没处理完，子线程就把数据改了。程序跑起来时好时坏，查了两天才找到原因。

  核心原则： 跨线程传递数据时，尽量传递值类型或深拷贝的数据。避免传递指针、引用或迭代器。

Qt的元对象系统在QueuedConnection下，会自动对参数进行深拷贝。但前提是——参数类型必须被注册到元类型系统。这就引出了下一个重点。

4.5 参数类型注册：qRegisterMetaType

为什么需要注册？因为QueuedConnection在传递参数时，需要把参数存储到事件队列里。Qt必须知道这个类型的大小、如何拷贝、如何析构。对于基础类型（int、double、QString等）和Qt自己的类型（QVector、QMap等），Qt已经内置支持了。

但自定义类型不行。比如你定义了一个struct MyData，直接用在信号参数里，编译能过，运行时会报错：

QObject::connect: Cannot queue arguments of type 'MyData'
(Make sure 'MyData' is registered using qRegisterMetaType().)

解决办法很简单，两步走：

在头文件里用Q_DECLARE_METATYPE宏声明类型
在代码里调用qRegisterMetaType注册

// 第一步：声明元类型
struct MyData {
    int id;
    QString name;
    double value;
};
Q_DECLARE_METATYPE(MyData)

// 第二步：注册（通常在main函数或构造函数里）
qRegisterMetaType<MyData>("MyData");

// 然后就可以安全地跨线程传递了
connect(worker, &Worker::resultReady,
        receiver, &Receiver::onResult,
        Qt::QueuedConnection);

💡 我的习惯： 在自定义类的构造函数里注册，或者在main函数一开始就注册所有需要的类型。这样不会漏掉。

4.6 实战对比表

特性	DirectConnection	QueuedConnection
执行线程	发送者线程	接收者线程
执行时机	立即执行	排队等待事件循环
线程安全	不安全（需自行加锁）	相对安全（参数自动拷贝）
参数传递	引用传递	深拷贝传递
自定义类型	不需要注册	需要qRegisterMetaType
适用场景	同线程、性能敏感	跨线程、UI更新

4.7 避坑指南

最后，分享几个我踩过的坑，希望能帮你少走弯路：

我曾经忘记注册自定义类型，结果信号发了但槽函数没反应，调试了半天才发现是类型没注册。记住：QueuedConnection下，自定义类型必须注册。
我曾经在子线程里直接操作UI控件，程序崩溃后查文档才知道UI操作必须在主线程。用QueuedConnection把信号发到主线程处理就好。
注意：如果接收者线程没有事件循环（比如QThread默认没有），QueuedConnection的信号永远不会被处理。我建议用QThread时，确保调用了exec()启动事件循环。
还有一个细节：信号参数如果是const引用，QueuedConnection会自动拷贝一份。但如果是非const引用，编译会报错。所以跨线程信号参数最好用const引用或值传递。

嗯，跨线程信号槽其实不难，关键是理解两种连接方式的本质区别。记住一句话：同线程用Direct，跨线程用Queued。再加上类型注册，基本就能应对大部分场景了。

  总结： 跨线程信号槽的核心就是让槽函数在正确的线程执行。DirectConnection直接但危险，QueuedConnection安全但有开销。根据场景选对连接方式，再配合qRegisterMetaType注册自定义类型，你的多线程通信就能稳如泰山。

可可精品资料库