第一次打开Qt Creator时，面对空白的项目向导和陌生的控件面板，很多人会问：一个按钮被点击后怎么能让标签上的文字立刻改变？这背后的魔法就是Qt的核心机制——信号与槽。它让C++编写的桌面应用各组件之间的通信变得异常简洁，同时完全类型安全。下边这个例子会手把手带你用Qt Creator走完从项目创建到连接第一个信号与槽的完整过程。
一、新建一个带图形界面的C++项目
启动Qt Creator后，点击菜单栏的「文件」→「新建文件或项目」，在弹出的向导中选择「Application」组里的「Qt Widgets Application」。Widgets代表我们要使用经典的桌面控件库，而不是QML。接着给项目取一个名字，比如“FirstSignalSlot”，然后选择构建套件，如果没有特殊需求保持默认即可。
在定义基类时，向导会要求你选择主窗口的类型。为了最简洁地演示信号与槽，选择QWidget作为基类（另一个常用基类是QMainWindow，它自带菜单栏、工具栏和状态栏，但对于入门示例过于庞大）。勾选“生成界面”复选框，这样向导会同时生成.ui文件，双击它就能打开可视化设计器。剩下的步骤一直点“下一步”完成项目创建，现在左侧项目视图中已经出现了main.cpp、widget.h、widget.cpp和widget.ui四个核心文件。
理解这几个文件的分工很重要：main.cpp只负责创建应用程序对象并显示主窗口；widget.h声明我们的主控件类；widget.cpp实现它的功能；而widget.ui存储着用拖拽方式搭建的界面布局，它会被uic工具编译成ui_widget.h头文件。这种分离的设计让我们能把界面外观和业务逻辑清晰地剥离开，信号与槽正是连接两者的桥梁。
二、在可视化设计器中准备按钮和标签
双击widget.ui进入设计模式，右侧是一个空白的窗体。打开左侧「Display Widgets」分组，从中拖一个Label（标签）到窗体上；再打开「Buttons」分组，拖一个Push Button（按钮）到窗体上。选中按钮，在右下方的属性编辑器里找到“text”属性，将其值改成“点击我”。同样的方法把标签的text改成“等待连接…”。适当调整控件大小和位置，让窗口看起来整洁一些。
这样我们就拥有了一个简单的用户界面：一个按钮和一个标签。按钮负责发出信号，标签需要响应事件。Qt通过元对象系统把信号的发射和槽的调用完美解耦，我们只需要告诉框架“谁发出信号”和“谁来响应”即可。在标准C++里没有这种内建的事件驱动机制，你得多写很多回调代码，而Qt的connect语句能让你像搭积木一样组合组件行为。
为了让信号与槽能够工作，Qt使用了一个名为MOC（Meta-Object Compiler）的代码预处理器。当你查看widget.h时，可以看到类声明中有一个Q_OBJECT宏，正是这个宏触发了MOC的处理。MOC会扫描头文件中用signals和slots关键字声明的部分，并生成额外的C++代码来支持运行时类型信息、动态属性和信号与槽的连接。对初学者来说，只要记得在每一个自定义控件类的开头加上Q_OBJECT就不会出错。
三、用两种方式连接按钮点击和标签更新
第一种方法完全基于可视化操作，不需要写一行代码。在设计器界面右击Push Button控件，选择“转到槽…”。弹出的窗口中列出了该按钮所有可能的信号，如clicked()、pressed()、released()等。我们选择clicked()，然后点击OK。Qt Creator这时会自动做两件事：在widget.h中声明一个on_pushButton_clicked()的私有槽函数，并在widget.cpp中生成对应的空函数体。这就是依赖命名约定的自动连接机制，它的格式是on_<对象名>_<信号名>。
在自动生成的空函数体内，添加一行代码来改变标签文字：
void Widget::on_pushButton_clicked()
{
ui->label->setText("第一个信号与槽连接成功！");
}
这里的ui指针是Qt自动为.ui文件创建的界面对象，它管理着所有可视控件。setText是QLabel的成员函数，点击按钮后标签就会显示新的字符串。现在点击左下角的绿色三角形运行程序，当按钮被单击时，标签上的文字果然发生了变化。这种图形化连接方式非常适合快速原型设计，但它的缺点是把信号和槽的名字固定死了，不适合复杂解耦的场景。
第二种方式是手工调用connect()函数，它能让我们自由地连接任意对象和任意信号与槽，甚至可以把一个信号连接到另一个信号上。首先把刚才自动生成槽函数时的修改撤销（或者新建一个不带自动连接的干净项目）。然后在widget.cpp的构造函数里，使用connect语句显式绑定：
Widget::Widget(QWidget *parent)
: QWidget(parent)
, ui(new Ui::Widget)
{
ui->setupUi(this);
connect(ui->pushButton, &QPushButton::clicked,
this, &Widget::onButtonClicked);
}
同时需要在widget.h中声明自定义槽函数onButtonClicked，并在widget.cpp中实现它。注意，connect的语法使用了函数指针方式（Qt5的新写法），它比过去依赖SIGNAL和SLOT宏的旧式写法更安全，因为编译期就会检查信号和槽的参数是否匹配。例如clicked()信号不带参数，而我们的槽函数也没有参数，刚好吻合。
四、弄明白信号与槽到底解决了什么问题
传统的GUI框架常用回调函数来处理事件，但回调函数有几个头疼的问题：一是强耦合，调用者必须知道回调接收者的具体类型；二是不好管理生命周期，容易造成空悬指针；三是不支持多对多通信。Qt的信号与槽完全解决了这些痛点。信号由一个对象发出，槽在另一个对象中实现，它们之间通过元对象系统动态查找，完全解耦。一个信号可以连接多个槽，多个信号也可以连接到同一个槽，连接的顺序是可以控制的。
从底层原理看，每个QObject子类都维护着一张内部的连接表。当调用connect时，系统会把信号索引、槽接收者、槽索引等信息存入表中。对象调用emit发出信号时，MOC生成的代码会遍历这张表，依次调用所有与该信号相关的槽函数。如果连接类型指定为Qt::DirectConnection，槽函数会在信号发出的同一线程中同步执行；若指定为Qt::QueuedConnection，则会将槽函数调用包装为一个事件投递到接收者所在线程的事件循环中，这对跨线程通信至关重要。
很多开发者最初只在单线程里使用信号与槽，其实这也是它的巨大优势：所有UI操作都在主线程中执行，而耗时的计算或网络请求可以放在工作线程里，处理完成后通过信号把结果传递回主线程，再在槽函数中更新界面。这种线程间通信方式比直接操作共享数据要安全得多，因为它天然避免了锁竞争和UI渲染冲突。
掌握了这个简单的按钮到标签的连接后，你已经触碰到了Qt最迷人的部分。接下来无论是加入更多控件、完成自定义信号，还是设计复杂的数据流，信号与槽的机制都会一直为你提供清晰、安全的事件通信方式。
Qt_Creator信号与槽C++桌面应用修改时间：2026-08-12 14:07:55