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()));(已不推荐,无类型安全)
一个完整的小例子
比如按钮点击后更新标签文字:
立即学习“C++免费学习笔记(深入)”;
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 开发的核心习惯之一。










