Qt 信号槽原理与多线程连接类型

信号与槽（Signals & Slots）是 Qt 框架的核心基石，它提供了一种类型安全、松散耦合的对象间通信机制。在多线程编程中，合理配置信号槽的连接类型，是保证跨线程调用数据安全与同步的关键。

本篇将深入剖析 Qt 信号槽的编译与执行机制，并重点详解 5 种核心的连接类型（Qt::ConnectionType）。

1. 信号与槽的底层机制：MOC 与元对象系统

在 C++ 编译期，标准的编译器并不能识别 signals、slots 或 emit 这一类 Qt 专属关键字。Qt 是通过 MOC (Meta-Object Compiler，元对象编译器) 来支持这些特性的。

扫描头文件：编译开始前，MOC 会扫描项目头文件，寻找包含 Q_OBJECT 宏的类。
生成元对象代码：为该类自动生成一个名为 moc_xxx.cpp 的源文件。
实现信号函数：信号在头文件中只需声明，无需编写具体的 C++ 实现代码，MOC 会在 moc_xxx.cpp 中自动生成信号函数的具体实现（用于打包参数并通知连接的槽函数）。
元数据映射：生成保存类名、信号与槽函数名及其参数索引的字符串数组，从而在运行期支持反射（Reflection）与动态函数定位。

在使用 QObject::connect() 时，第五个参数决定了信号发出后，槽函数在哪个线程、以何种形式被执行：

cpp

QObject::connect(sender, &Sender::sig, receiver, &Receiver::slot, Qt::AutoConnection);

规则：如果发送者信号发出的线程与接收者对象所属的线程（即 receiver->thread()）相同，则自动转换为 DirectConnection；如果不同，则自动转换为 QueuedConnection。
适用场景：绝大多数常规开发场景。

规则：信号发出后，信号参数被打包成事件（QMetaCallEvent）投递到接收者线程的事件队列中。当接收者线程的事件循环（Event Loop）轮询到该事件时，才在接收者线程中执行槽函数（异步调用）。
关键点：
1. emit 语句立即返回，不会阻塞发送者线程。
2. 参数跨线程传递必须注册：通过 QueuedConnection 传递自定义数据类型时，必须使用 qRegisterMetaType<T>() 注册，否则打包事件会失败。
适用场景：主线程与工作线程（Worker Thread）之间的跨线程通信。

Qt 中的对象具有线程依附性（Thread Affinity），由 QObject::thread() 决定。

cpp

Worker *worker = new Worker(); // 依附于创建它的主线程
QThread *thread = new QThread();
worker->moveToThread(thread); // 将 worker 的线程依附性改变为新线程

在信号槽跨线程调用中，判断是否开启 QueuedConnection 的唯一依据是 receiver->thread() 是否等于当前 emit 所在的线程，而不是类代码书写的位置。

底层支撑：Qt 信号槽依靠 MOC 预编译生成元对象代码，利用字符串映射与函数索引实现类型安全的解耦通信。
连接选择：同线程优先同步直接调用（DirectConnection）；跨线程优先事件队列投递（QueuedConnection）；跨线程返回值同步可考虑阻塞连接（BlockingQueuedConnection）。
安全红线：跨线程队列连接传输自定义类型前，务必调用 qRegisterMetaType<T>() 完成元类型注册。