C++如何使用信号和槽（Signal & Slot）？（Qt框架示例）

Qt信号槽是框架提供的通信机制，需继承QObject并使用Q_OBJECT宏；信号用signals声明、无返回值、只能emit触发，槽为普通成员函数；通过connect连接，推荐新语法以保障类型安全。

Qt 的信号和槽机制不是 C++ 语言原生特性，而是 Qt 框架提供的对象间通信方式。它通过元对象系统（Meta-Object System）实现，需要继承 QObject 或其子类，并配合 Q_OBJECT 宏使用。

信号和槽的基本写法

信号用 signals: 关键字声明，是特殊的 void 成员函数，不能有返回值、不能被直接调用（只能用 emit 触发）。槽是普通成员函数，可以是 public、protected 或 private，可被直接调用，也可响应信号。

连接用 QObject::connect()，语法简洁：

• connect(sender, &Sender::signalName, receiver, &Receiver::slotName);（推荐，编译期检查）
• 旧式写法：connect(sender, SIGNAL(signalName()), receiver, SLOT(slotName()));（已不推荐，无类型安全）

一个完整的小例子

比如按钮点击后更新标签文字：

class MainWindow : public QMainWindow {
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
        QPushButton *btn = new QPushButton("点我", this);
        QLabel *label = new QLabel("等待点击...", this);

        // 连接：按钮的 clicked() 信号 → 主窗口的 updateLabel() 槽
        connect(btn, &QPushButton::clicked, this, &MainWindow::updateLabel);

        QVBoxLayout *layout = new QVBoxLayout;
        layout->addWidget(btn);
        layout->addWidget(label);
        QWidget *central = new QWidget;
        central->setLayout(layout);
        setCentralWidget(central);
    }

public slots:
    void updateLabel() {
        static int count = 0;
        label->setText(QString("已点击 %1 次").arg(++count));
    }

private:
    QLabel *label; // 需在类中持有指针，或改用 findChild 等方式访问
};

注意几个关键点

• 必须在类声明开头加 Q_OBJECT 宏，否则 moc（元对象编译器）不会生成信号/槽支持代码
• 项目需启用 moc：CMake 中用 qt_add_executable() 或 set(CMAKE_AUTOMOC ON)；qmake 自动处理
• 信号和槽参数类型与顺序必须严格匹配（或可隐式转换），否则连接失败（运行时警告）
• 支持 Lambda 表达式作为槽：connect(btn, &QPushButton::clicked, [=]() { qDebug()
• 连接可设策略（如 Qt::QueuedConnection），跨线程通信时尤其重要

常见问题排查

如果信号没触发槽，先检查：

• 类是否继承 QObject，是否写了 Q_OBJECT
• 是否重新运行了 qmake / cmake 生成 moc 文件（修改含 Q_OBJECT 的头文件后必须重建）
• 连接语句是否在对象创建之后执行（sender 和 receiver 必须已存在）
• 控制台是否输出 QObject::connect: No such signal 类错误（拼写或签名不对）

基本上就这些。信号和槽解耦清晰、线程安全（合理配置下）、用起来很自然，是 Qt 开发的核心习惯之一。