本章重要 API 函数#

💡 Tips：connect 第五个参数 Qt::ConnectionType 决定同步/异步——默认 Qt::AutoConnection 在同线程为直接调用、跨线程为队列投递。QOverload 是连接重载信号槽的唯一干净写法：本项目 A 同时有 a_signal() 和 a_signal(int)，不写 QOverload 编译器无法确定取哪个重载而报错。Qt5 旧式 SIGNAL("a_signal(int)") 宏是运行时字符串匹配（拼错不报编译错、只静默失败）；Qt5 新式函数指针是编译期检查，更安全。Qt6 仍保留旧宏但已标记为 legacy，新代码一律用函数指针对。

本章目录#

点击条目可跳转到对应小节。

学习前后依赖#

💡 Tips：必须先会 QObject 继承与 moc 流程，否则 Q_OBJECT 宏报 “undefined reference to vtable” 时会完全看不懂。本篇是后续所有 GUI 交互（按钮、菜单、拖拽、网络通信）的基石——没有信号槽，Qt 就退化成普通 C++ 绘图库。

1. 概述#

信号与槽（Signal & Slot）是 Qt 为解决对象间松耦合通信而设计的机制。在传统的回调（callback）里，A 调用 B 的函数必须硬知道 B 的接口类型，二者编译期就耦合在一起。而信号槽让”发出方”完全不认识”接收方”：类 A 只管 emit a_signal()，至于谁在听、听完后做什么，A 一概不知。

本项目的 info.h 定义了两个最朴素的类：A 负责发信号，B 负责收信号执行 b_slot()。这正是信号槽最经典的”一对多、多对一、解耦”演示：A 甚至不需要包含 B 的逻辑头文件（这里仅为演示才一起编译）。

💡 Tips：记住一句话——信号由 moc 自动生成实现，你永远不要在 .cpp 里手写信号的函数体；槽则相反，必须在 .cpp 里给出实现。初学者最反直觉的点就在这里：你 emit 了一个从没写过函数体的东西，它居然能”凭空”执行别人的代码。

2. 核心概念 / 原理#

信号槽在底层依赖 Qt 的元对象系统（Meta-Object System）。当你在类里写 Q_OBJECT 宏，Qt 的 moc（Meta-Object Compiler）会在编译前扫描这个类，生成 moc_info.cpp，里面包含：信号的桩函数实现、信号与槽的名字字符串表、以及用于运行时按名字查找的 qt_metacall / qt_metacast。

connect(sender, &A::a_signal, receiver, &B::b_slot) 的本质：在发送者的内部连接表里登记一条记录（发送者、信号索引、接收者、槽索引）。当 emit a_signal() 时，moc 生成的信号函数会遍历这条连接表，逐个调用接收者的 qt_metacall，最终落到 B::b_slot()。

1
// info.h 中的声明（moc 据此生成代码）
2
class A : public QObject {
3
    Q_OBJECT
4
signals:
5
    void a_signal();        // moc 生成其实现，你不要写
6
    void a_signal(int);     // 重载版本
7
};
8
class B : public QObject {
9
    Q_OBJECT
10
public slots:
11
    void b_slot();          // 必须自己在 info.cpp 实现
12
    void b_slot(int);
13
};

💡 Tips：原理层面最易误解的是——默认情况下信号槽是”同步、直接”的函数调用，不是消息队列、不是线程。除非跨线程且连接类型被设为 Qt::QueuedConnection，否则 emit 返回时，所有被连接的槽已经全部执行完毕。这和”发消息后立刻往下走”的异步直觉不同。

3. connect → emit → 槽调用链路#

下面用时序图展示本工程 test2() 中 A a; B b; 之后，一次 emit a.a_signal(10) 的完整调用链（注意 QOverload<int> 把这次 emit 精确路由到 b_slot(int)）：

💡 Tips：流程里最关键的箭头是 A → Conn → B 这一段：信号本身不直接调用 B，而是先经过 moc 生成的连接表做”分发”。这也解释了为什么一个信号能同时连多个槽（遍历表即可），以及为什么跨线程时能把调用”搬运”到接收者所在线程的事件循环里。

4. 核心代码解析#

1
class A : public QObject {
2
    Q_OBJECT
3
public:
4
    A(QObject *parent = nullptr);
5
    ~A();
6
signals:
7
    void a_signal();
8
    void a_signal(int);     // 重载信号：无参 + int
9
};
10
class B : public QObject {
11
    Q_OBJECT
12
public:
13
    B(QObject *parent = nullptr);
14
    ~B();
15
public slots:
16
    void b_slot();
17
    void b_slot(int);
18
};

1
void test2() {
2
    A a; B b;
3
    // 旧式宏（注释掉，演示用）：
4
    // QObject::connect(&a, SIGNAL(a_signal()), &b, SLOT(b_slot()));
5
    // 新式函数指针 + QOverload 解决重载歧义：
6
    QObject::connect(&a, QOverload<>::of(&A::a_signal),
7
                         &b, QOverload<>::of(&B::b_slot));
8
    QObject::connect(&a, QOverload<int>::of(&A::a_signal),
9
                         &b, QOverload<int>::of(&B::b_slot));
10
    emit a.a_signal();      // 触发无参重载 -> b_slot()
11
    emit a.a_signal(10);    // 触发 int 重载  -> b_slot(10)
12
}
13
int main(int argc, char *argv[]) { test2(); return 0; }

5. 运行效果 / 验证#

编译运行（Qt6 + MinGW，见 CMakeLists 中 find_package(Qt6 ... Core Widgets)）后，控制台应输出：

1
b_slot
2
b_slot 10

顺序对应 emit a.a_signal()（无参 → b_slot()）和 emit a.a_signal(10)（int → b_slot(10)）。只要两条日志都出现，就证明信号触发、连接表分发、槽执行三段链路全部打通。

💡 Tips：验证时容易误判”成功”的假象——若只看到程序一闪而过没有输出，可能是 test1() 那种”只 emit 没 connect”的版本在跑（注释里就是），或 main 没调用 test2()。务必确认 main 调用的是 test2，且 Q_OBJECT 类所在的 .cpp 都参与了 moc 编译（Qt6 的 qt_add_executable 会自动处理，但手写 CMake 漏掉源文件会报 vtable 错）。

容易踩坑（注意点）#

• 坑 1：undefined reference to vtable for A。原因：类写了 Q_OBJECT 但没被 moc 处理（源文件没加入构建列表，或忘了 #include "moc_info.cpp"）。规避：用 qt_add_executable 把 info.cpp 列入源文件，让 CMake 自动调用 moc。
• 坑 2：重载信号/槽连接编译报错”cannot resolve overloaded function”。原因：没用 QOverload 指明具体重载。规避：QOverload<int>::of(&A::a_signal)；Qt5 旧式可用 static_cast<void(A::*)(int)>(&A::a_signal)。
• 坑 3：用了旧式 SIGNAL/SLOT 宏但拼错字符串，运行时静默不连接。原因：宏是字符串匹配，编译期不检查。规避：一律用新式函数指针写法。
• 坑 4：信号声明却”自己实现”了函数体。原因：信号由 moc 生成，手写会重定义。规避：信号只在 signals: 区声明，绝不写实现。
• 坑 5：跨线程连接期望同步拿到结果却拿到旧值。原因：跨线程默认 QueuedConnection，emit 立即返回、槽稍后执行。规避：同线程才是直接调用；需要结果就改用返回值/直接调用，或 Qt::BlockingQueuedConnection（注意死锁风险）。
• 坑 6：Q_OBJECT 写在 private: 之后导致 moc 虚函数私有化。现象为链接错误。规避：永远把 Q_OBJECT 放在类体最前面。

学习要点总结#

Q&A（常见问题）#

Q1：信号和槽的参数必须完全一样吗？ A1：连接时，槽的参数个数可以少于或等于信号的参数个数，但前面的类型必须一一对应。例如信号 a_signal(int, QString) 可连到槽 b_slot(int)（丢弃第二个参数）；但不能连到 b_slot(QString)（类型顺序不匹配）。本项目 a_signal(int) 连 b_slot(int) 是严格一致的。

Q2：事件（event）和信号槽到底是什么关系？ A2：二者不同层次。事件是更底层的”输入/系统通知”（鼠标、键盘、定时器、绘图），由 QApplication::notify 分发；信号槽是建立在 QObject 之上的对象间通信抽象。许多信号槽其实是由事件触发的——比如 QPushButton::clicked 信号，本质是按钮在 mouseReleaseEvent 里 emit 出来的。所以”事件驱动信号，信号驱动槽”。

Q3：Qt5 和 Qt6 在 connect 上有区别吗？ A3：核心函数指针写法在 Qt5.0+ 与 Qt6 一致；区别在于 Qt6 正式废弃了旧的 SIGNAL/SLOT 字符串宏（仍可用但警告），并默认要求 C++17。此外 Qt6 的 QOverload 用法不变。新项目一律用函数指针 + QOverload，避免旧宏的拼写隐患。

Q4：一个信号能连多个槽吗？调用顺序如何？ A4：可以，且默认按 connect 的注册顺序同步调用。这正体现了信号槽”一对多”的解耦优势——A 完全不知道有几个 B 在接收。

Tips（全局速记）#