3、信号与槽机制：信号与槽原理、connect函数详解、自定义信号与槽、Lambda表达式

信号与槽，是Qt最核心的机制，没有之一。

我刚开始接触Qt时，第一反应是：这不就是回调函数吗？后来踩了几个坑才明白，它比回调函数优雅太多了。说白了，信号与槽就是Qt自己搞的一套对象间通信方案，让你不用写一堆回调注册代码，也不用操心线程安全问题。

3.1 信号与槽原理

信号与槽的本质，是一个观察者模式的实现。但Qt做得更绝——它用元对象编译器（MOC）在编译阶段就把信号和槽的调用关系给解析好了。

简单来说：

  • 信号（Signal）：当某个事件发生时，对象发射一个信号。比如按钮被点击，它就发射 clicked() 信号。
  • 槽（Slot）：就是一个普通的成员函数，只不过它可以被信号触发执行。
  • 连接（Connect）：把信号和槽绑定在一起。信号发射时，槽函数自动被调用。

嗯，这里要注意：信号只管发射，不关心谁在听。槽只管执行，不关心谁叫它。这种松耦合的设计，让代码的维护性好了不止一个档次。

核心要点：信号与槽的连接，是在运行时动态建立的。这意味着你可以在程序运行过程中随时断开或重新连接，非常灵活。

我在项目中遇到过一个问题：两个对象互相持有对方的指针，结果信号循环触发，导致栈溢出。后来我加了一个标志位判断，才解决。所以，设计信号链时一定要小心循环调用。

3.2 connect函数详解

connect 函数是信号与槽的桥梁。Qt 5 之后，connect 有几种写法，我挨个说说。

3.2.1 经典写法（Qt 4 风格）

connect(sender, SIGNAL(clicked()), receiver, SLOT(handleClick()));

这种写法用宏来指定信号和槽。优点是兼容性好，缺点是编译期不做类型检查。如果你把信号名写错了，编译器不会报错，运行时才会静默失败。我曾经因为这个排查了半天，最后发现是信号名少了个字母。

3.2.2 新式写法（Qt 5 风格）

connect(sender, &QPushButton::clicked, receiver, &MyClass::handleClick);

这种写法用函数指针，编译期就能检查类型是否匹配。我个人习惯用这种，安全又直观。

小技巧：如果槽函数有重载，需要显式指定函数指针类型，否则编译器会报歧义。比如：

connect(comboBox, QOverload<int>::of(&QComboBox::currentIndexChanged),
        this, &MyClass::onIndexChanged);

3.2.3 连接类型

connect 的第五个参数可以指定连接类型，默认是 Qt::AutoConnection：

连接类型 说明
AutoConnection 默认值。如果信号和槽在同一线程，用 DirectConnection；否则用 QueuedConnection。
DirectConnection 信号发射时，槽函数立即执行，在信号所在线程。
QueuedConnection 槽函数在接收对象所在线程的事件循环中执行，异步。
BlockingQueuedConnection 类似 QueuedConnection，但信号发射线程会阻塞，直到槽函数执行完毕。
UniqueConnection 可以和前面几种组合使用，确保同一个信号和槽只连接一次。

你想想看，如果信号和槽在不同线程，用 DirectConnection 会导致槽函数在信号线程执行，可能引发线程安全问题。所以，跨线程通信时，我建议用 QueuedConnection，或者干脆用默认的 AutoConnection。

3.3 自定义信号与槽

Qt 自带的信号和槽够用吗？大部分场景够。但有时候你需要定义自己的信号，比如自定义控件发出特定事件。

3.3.1 自定义信号

自定义信号很简单，只需要在类声明中用 signals: 关键字，然后声明函数原型即可。注意：信号只需要声明，不需要实现。

class MyWidget : public QWidget
{
    Q_OBJECT
public:
    explicit MyWidget(QWidget *parent = nullptr);

signals:
    void valueChanged(int newValue);
    void errorOccurred(const QString &errorMsg);
};

发射信号用 emit 关键字：

void MyWidget::setValue(int val)
{
    if (val != m_value) {
        m_value = val;
        emit valueChanged(m_value);
    }
}

注意：信号函数不能有返回值，只能是 void。因为一个信号可以连接多个槽，返回值没有意义。

3.3.2 自定义槽

槽就是普通的成员函数，只不过可以被信号触发。在 Qt 5 中，任何成员函数都可以作为槽，不需要特殊声明。但如果你用 Qt 4 风格，需要在 public slots: 或 private slots: 下声明。

class MyWidget : public QWidget
{
    Q_OBJECT
public:
    explicit MyWidget(QWidget *parent = nullptr);

public slots:
    void onValueChanged(int newValue);
    void reset();
};

我个人习惯把槽函数放在 public slots: 下，这样语义更清晰。不过说实话，用 Qt 5 的新式 connect 后，槽函数放在哪里都行，只要它是可访问的成员函数。

3.4 Lambda表达式

Lambda 是 C++11 引入的特性，Qt 5 的 connect 完美支持它。Lambda 表达式让你可以在连接处直接写槽逻辑，不用单独定义槽函数。

3.4.1 基本用法

connect(button, &QPushButton::clicked, this, [this]() {
    qDebug() << "按钮被点击了";
    this->doSomething();
});

你看，省去了定义一个槽函数的步骤。对于简单的逻辑，Lambda 非常方便。

3.4.2 捕获变量

Lambda 可以捕获外部变量：

int counter = 0;
connect(button, &QPushButton::clicked, this, [&counter]() {
    counter++;
    qDebug() << "点击次数:" << counter;
});

避坑指南：我曾经在 Lambda 中捕获了局部变量的引用，结果局部变量在 Lambda 执行前就被销毁了，导致程序崩溃。所以，如果 Lambda 可能在变量生命周期结束后执行，建议用值捕获 [=] 或者用智能指针。

3.4.3 注意事项

  • Lambda 中的 this 指针要小心。如果对象被销毁，Lambda 还在执行，就会访问野指针。建议在 connect 时指定接收对象为 this，这样对象销毁时连接会自动断开。
  • Lambda 表达式不能用于 Qt 4 风格的 connect，因为 Qt 4 的宏展开不支持模板。
  • 如果 Lambda 逻辑复杂，还是建议提取成独立的槽函数，方便调试和复用。

3.5 知识体系结构图

下面这张图，是我梳理的信号与槽机制的核心脉络，你看一眼就能把握全貌：

信号与槽机制知识体系 信号与槽 原理：观察者模式 + MOC编译期解析 connect函数详解 Qt4风格（宏） Qt5风格（函数指针） 连接类型（5种） 自定义信号与槽 signals: 声明，emit发射 槽 = 普通成员函数 Lambda表达式 捕获变量（值/引用） 注意生命周期和this 核心：松耦合、类型安全、灵活连接

信号与槽这套机制，说白了就是让对象之间能优雅地通信。你不需要知道对方是谁，也不需要关心对方怎么处理。这种设计模式，在大型项目中尤其好用——模块之间解耦，各自独立演进。

好了，这一章的内容就到这里。记住：多用新式 connect，少用宏；自定义信号时注意线程安全；Lambda 虽好，但别滥用。这些经验，都是我一个个坑踩出来的。

可可精品资料库

← 上一章 📖 返回目录 下一章 →