📚 课程目录第3章开发环境搭建

3. 开发环境搭建

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

我刚开始接触Qt时，觉得这东西不就是个回调函数吗？后来在项目中踩过几次坑，才真正理解它的设计哲学。说白了，信号与槽让对象之间可以松耦合地通信——发送者不需要知道谁在接收，接收者也不需要知道谁在发送。

3.1 信号与槽的基本原理

Qt的信号与槽机制，本质上是观察者模式的一种实现。但它比传统的回调函数强在哪？

类型安全：编译期检查参数类型，参数不匹配直接报错
松耦合：信号类不需要知道槽函数属于哪个类
多对多：一个信号可以连接多个槽，多个信号也可以连接同一个槽

我记得第一次用Qt做项目时，有个同事把信号参数写错了，编译直接报了一堆模板错误。当时觉得Qt好麻烦，后来才发现——编译期发现问题，总比运行时崩溃强。

核心流程：当某个事件发生时，对象发射（emit）一个信号，Qt的元对象系统（MOC）负责查找所有连接到该信号的槽函数，并依次调用它们。

来看一个最简单的例子：

// 按钮点击 -> 关闭窗口
QPushButton *btn = new QPushButton("关闭");
connect(btn, &QPushButton::clicked, this, &QWidget::close);

这行代码干了什么？

用户点击按钮，按钮发射 clicked() 信号
Qt的元对象系统找到 this 对象的 close() 槽函数
调用 close()，窗口关闭

你想想看，如果不用信号与槽，用传统回调函数会怎样？你得在按钮类里保存一个函数指针，还得考虑线程安全、对象生命周期……Qt把这些都封装好了。

3.2 自定义信号与槽

实际项目中，光用Qt自带的信号肯定不够。你需要定义自己的信号和槽。

先看一个我项目中的真实场景：一个温度传感器类，当温度超过阈值时通知主界面。

// sensor.h
class TemperatureSensor : public QObject {
    Q_OBJECT
public:
    explicit TemperatureSensor(QObject *parent = nullptr);
    void readTemperature();

signals:
    void temperatureExceeded(float currentTemp, float threshold);

private:
    float m_currentTemp;
};

// sensor.cpp
void TemperatureSensor::readTemperature() {
    // 模拟读取传感器
    m_currentTemp = 85.5f;
    float threshold = 60.0f;

    if (m_currentTemp > threshold) {
        emit temperatureExceeded(m_currentTemp, threshold);
    }
}

个人习惯：信号命名用过去分词或被动语态，比如 dataReceived()、errorOccurred()。槽函数命名用动词原形，比如 handleData()、updateUI()。这样一看代码就知道哪个是信号、哪个是槽。

接收端怎么用？

// mainwindow.cpp
TemperatureSensor *sensor = new TemperatureSensor(this);
connect(sensor, &TemperatureSensor::temperatureExceeded,
        this, &MainWindow::onTemperatureAlarm);

void MainWindow::onTemperatureAlarm(float temp, float threshold) {
    QString msg = QString("警告：温度 %.1f°C 超过阈值 %.1f°C")
                      .arg(temp).arg(threshold);
    QMessageBox::warning(this, "温度告警", msg);
}

这里有几个关键点要注意：

规则	说明
信号只能用 `signals:` 声明	信号没有实现体，由MOC自动生成
信号返回类型必须是 `void`	信号只负责通知，不负责返回值
槽可以是普通成员函数	用 `public slots:`、`protected slots:` 或 `private slots:` 声明
类必须继承 `QObject`	并且加上 `Q_OBJECT` 宏

我曾经踩过的坑：自定义类忘记加 Q_OBJECT 宏，结果信号死活连不上。编译没问题，运行时就是不触发。查了半天才发现是MOC没生成对应的元对象代码。记住：所有使用信号与槽的类，必须继承QObject并添加Q_OBJECT宏。

3.3 信号与槽的连接方式

Qt5之后，推荐使用新式语法（函数指针方式）。为什么？

编译期检查参数类型，避免运行时错误
支持自动类型转换
可以连接重载函数（需要配合 qOverload）

来看几种连接方式：

// 方式一：新式语法（推荐）
connect(sender, &Sender::valueChanged,
        receiver, &Receiver::handleValue);

// 方式二：旧式语法（基于字符串，不推荐）
connect(sender, SIGNAL(valueChanged(int)),
        receiver, SLOT(handleValue(int)));

// 方式三：Lambda表达式（后面细讲）
connect(sender, &Sender::valueChanged, this, [=](int v) {
    qDebug() << "收到值:" << v;
});

// 方式四：连接重载信号
connect(sender, qOverload<int>(&Sender::valueChanged),
        receiver, &Receiver::handleInt);

你想想看，旧式语法用字符串，编译期不检查。万一你拼写错了，运行时才报错，那多难受？新式语法在编译期就能发现问题。

3.4 Lambda表达式在信号与槽中的应用

Lambda表达式是C++11引入的特性，在Qt信号与槽中特别好用。我个人习惯在以下场景使用Lambda：

槽函数逻辑简单，不值得单独写一个成员函数
需要捕获当前作用域的变量
临时性的连接，不需要持久化槽函数

来看一个实际例子：

// 场景：点击按钮，更新标签文本，同时记录日志
QPushButton *btn = new QPushButton("点击我");
QLabel *label = new QLabel("等待点击...");

connect(btn, &QPushButton::clicked, this, [=]() {
    label->setText("按钮被点击了！");
    qDebug() << "用户点击了按钮，时间:" << QTime::currentTime();
});

Lambda的捕获方式要注意：

捕获方式	含义	使用场景
`[=]`	值捕获所有外部变量	简单场景，只读变量
`[&]`	引用捕获所有外部变量	需要修改变量，但要注意生命周期
`[this]`	捕获当前对象的指针	访问类的成员变量和函数
`[=, &x]`	混合捕获	大部分值捕获，个别变量引用捕获

我曾经踩过的坑：在Lambda里用引用捕获局部变量，结果槽函数执行时局部变量已经销毁了。程序直接崩溃。记住：如果槽函数是异步执行的（比如跨线程），一定要用值捕获，或者确保被引用对象的生命周期比槽函数长。

3.5 信号与槽的知识体系

为了让你更直观地理解信号与槽的整体架构，我画了一张图：

3.6 避坑指南与最佳实践

做了这么多年Qt开发，我总结了几条信号与槽的使用经验：

核心原则：信号与槽的参数类型必须匹配，参数数量可以少于信号（多余参数被忽略），但不能多于信号。

具体来说：

参数类型要一致：信号发射 int，槽接收 int，不能是 QString
槽的参数可以更少：信号有3个参数，槽可以只接收前2个，后面的忽略
避免在构造函数中连接信号：如果对象还没完全初始化，槽函数可能访问到无效成员
断开连接用 disconnect：对象销毁前自动断开，但手动管理更安全

我建议：在团队协作中，统一信号与槽的命名规范。比如信号用 xxxChanged、xxxReady、xxxError，槽用 onXxxChanged、handleXxx。这样代码可读性会好很多。

还有一个常见问题：信号与槽的执行顺序。同一个信号连接了多个槽，执行顺序是不确定的。不要依赖连接顺序来实现业务逻辑。如果必须保证顺序，那就只连接一个槽，在槽里按顺序调用其他函数。

嗯，信号与槽的内容就讲到这里。记住一句话：信号与槽是Qt的灵魂。理解它、用好它，你的Qt开发之路会顺畅很多。