第一个 Qt Widgets 程序
从 main 函数到事件循环,拆解 Qt 程序的骨架
#一个最小的窗口程序
上一章末尾我们跑起来了一个只有一个按钮的程序。这一章把它拆开,逐行搞清楚"为什么必须这么写"。先看一个更规范的版本——创建一个自己的窗口类,而不是直接在 main 里摆控件:
// main.cpp
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QDebug>
class MyWindow : public QWidget
{
public:
explicit MyWindow(QWidget *parent = nullptr) : QWidget(parent)
{
setWindowTitle("我的第一个 Qt 窗口");
resize(400, 300);
auto *button = new QPushButton("点我一下", this);
button->move(150, 130);
connect(button, &QPushButton::clicked,
this, [this]() {
qDebug() << "按钮被点击了";
setWindowTitle("谢谢你");
});
}
};
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
MyWindow w;
w.show();
return app.exec();
}把它放进上一章的 CMakeLists.txt(源码文件换成 main.cpp)即可编译运行。你会看到一个 400×300 的窗口,中间有个按钮,点击后窗口标题变成"谢谢你",同时在 Qt Creator 的"应用程序输出"面板里打印一行日志。
#main 函数:QApplication 是什么
int main(int argc, char *argv[]) 这个签名你可能觉得眼熟——和标准 C++ 的 main 完全一样。但注意 Qt 期望的是非 const 的 char *argv[],因为 Qt 内部可能会修改命令行参数数组(它会吃掉自己识别的参数,比如 -style)。写成 const char *argv[] 会编译失败,这是初学者常见的第一个错误。
QApplication app(argc, argv); 这一行做了四件大事:
- 构造应用程序对象,它是整个程序的单例管理者,保存全局状态(如字体、调色板、样式)。
- 解析命令行参数,处理 Qt 自己的选项(
-style fusion、-platform等)。 - 初始化窗口系统与资源,建立与操作系统 GUI 子系统的连接。在 Linux 上它会连接 X11 或 Wayland;在 macOS 上建立 NSApplication。
- 准备事件循环,为后面的
exec()做准备。
QApplication 继承自 QGuiApplication,后者继承自 QCoreApplication。这个继承链正好对应模块划分:如果你写的是纯控制台程序(无界面),用 QCoreApplication;有界面但不使用 Widgets(比如纯 QML 或 OpenGL 程序),用 QGuiApplication;使用 Widgets 控件,必须用 QApplication。用错类型会导致某些功能不可用(比如在 QCoreApplication 下创建 QWidget 会直接崩溃并给出明确提示)。
如果你习惯了 Web 前端,这里有个很好的类比:QApplication 就像是 document 与浏览器运行时的合体——它不是任何一个"页面",但所有页面都活在它提供的环境里。Java Swing 中并没有完全对应的东西,最接近的是 SwingUtilities.invokeLater() 背后那个 AWT 事件派发线程(EDT)的概念。
Qt 5 提示:Qt 5 中同样是这三个类,行为一致。差别在于 Qt 6 把
QApplication的部分绘图相关初始化下沉到了QGuiApplication,并且 Qt 6 对高 DPI 缩放默认开启,Qt 5 需要手动设置Qt::AA_EnableHighDpiScaling。
#QWidget 与 QMainWindow
QWidget 是所有界面控件的基类。按钮、标签、输入框、窗口,乃至一个滚动条,全部继承自 QWidget。它有两条"人格":
- 当它的 parent 为 nullptr 时,它是一个顶层窗口,会出现在任务栏、有标题栏和边框;
- 当它有 parent 时,它是一个子控件,被嵌在父窗口内部,坐标相对于父窗口。
这就是为什么上面代码里 MyWindow 调用 show() 之后就成了一个独立窗口,而 new QPushButton("点我一下", this) 因为传了 this 作为 parent,就成了窗口内部的按钮。
QMainWindow 则是 QWidget 的一个特殊子类,专为"主窗口"设计:它预置了菜单栏、工具栏、状态栏、可停靠面板和中央部件的框架。当你写"正经的应用程序"(编辑器、IDE、管理工具)时应该继承 QMainWindow;写简单工具窗口或自定义控件时继承 QWidget。第 8 章会展开 QMainWindow。
对比一下 Tkinter:Tkinter 里 Tk() 是根窗口,Frame 是容器,二者是不同类;Qt 里根窗口和容器都是 QWidget,只是 parent 有无的区别。这个设计让 Qt 的控件可以任意嵌套组合,非常灵活。
#show() 与事件循环
w.show() 只是把窗口标记为"应该可见",真正的绘制要等到事件循环跑起来之后才会发生。与之相对的 hide() 隐藏窗口,还有 close()(会触发关闭事件,可被拦截)。
关键的一行是 return app.exec();。这一调用会阻塞,进入所谓的事件循环(event loop),直到程序收到退出信号(通常是最后一个窗口被关闭)才返回。事件循环本质上就是一个无限循环:
while (还没有收到退出请求) {
取出一个事件(鼠标点击、键盘按下、定时器到期、网络数据到达…)
把这个事件派发给对应的对象
处理完毕,继续取下一个
}在事件循环运行期间,你的 main 函数就"停"在这一行了,之后的代码只有在程序退出后才会执行。这个模型在 GUI 框架中是通用的:
- Java Swing:事件派发线程(EDT)做同样的事,你写
new JFrame().setVisible(true)之后 main 就结束了,但 EDT 线程还活着,所以程序不退出。 - Web 浏览器:JS 的事件循环(event loop)与消息队列,处理 click、setTimeout、fetch 回调。
- Python Tkinter:
root.mainloop(),名字都几乎一样。
理解"main 停住了,程序靠回调驱动"这一点,是从命令行程序思维转向 GUI 思维的第一道门槛。命令行程序是你主导流程:读输入、算、输出、结束。GUI 程序是用户主导流程:你只能注册"当某某发生时做什么",然后交出控制权。这个"注册回调"的动作在 Qt 里就是信号与槽,下一章的主角。
在事件循环之前 new 出来的对象(如上面的 button)不需要手动 delete——因为它们的 parent 是 this(窗口对象),窗口销毁时会自动清理。这是 Qt 的对象树机制,第 4 章详述。现在你只需要记住:在 Qt 里,有 parent 的控件不要手动 delete。
#qDebug:Qt 的 printf
qDebug() << "按钮被点击了" << someValue; 是 Qt 的调试输出工具,输出到 stderr(在 Qt Creator 里显示在"应用程序输出"面板)。它的优点是可以像 std::cout 一样链式输出,而且自动识别 Qt 的所有类型(QString、QList、QRect 都会打印成人类可读的形式,std::cout 则完全不认它们)。
相关的还有 qInfo()、qWarning()、qCritical()、qFatal()(后两者分别是严重错误与致命错误,qFatal 会直接终止程序)。它们构成一个简易的分级日志系统,比 std::cout 实用得多。
qDebug 在 Release 构建中依然有效;如果你想彻底关掉它,可以定义 QT_NO_DEBUG_OUTPUT。另外 Qt 6 提供了 QLoggingCategory,可以按模块开关日志,这是大型项目的做法。
对比:Java 里打日志通常要引入 Log4j/SLF4J 并配置 appender;Python 用
logging模块。Qt 的qDebug相当于零配置的std::cout做不到。
#完整的 CMakeLists.txt
把上一章的 CMake 配置补全,加入多文件支持(这是你接下来所有示例的模板):
cmake_minimum_required(VERSION 3.16)
project(FirstWindow LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)
find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
add_executable(FirstWindow
main.cpp
)
target_link_libraries(FirstWindow PRIVATE
Qt6::Core
Qt6::Gui
Qt6::Widgets
)
set_target_properties(FirstWindow PROPERTIES
MACOSX_BUNDLE TRUE
)
if(WIN32)
set_target_properties(FirstWindow PROPERTIES WIN32_EXECUTABLE TRUE)
endif()其中 MACOSX_BUNDLE TRUE 让 macOS 下生成 .app 捆绑包,WIN32_EXECUTABLE TRUE 则让 Windows 下不弹出多余的控制台黑框。
注意 target_link_libraries 里 Qt6::Widgets 已经隐式依赖 Gui 和 Core,显式写出来只是为了清晰。另外在 Qt 6 中,链接 Qt6::Widgets 会自动把 Qt 的插件路径、平台插件(如 qwindows.dll)等处理好;发布程序时仍需用 windeployqt / macdeployqt 工具复制依赖库,这是打包阶段的事。
#程序结构剖析
把上面的程序抽象成模板,你以后写的每一个 Qt Widgets 程序都是这个形状:
- 包含头文件:
#include <QApplication>加上你用到的控件。 - 定义窗口类:继承
QWidget或QMainWindow,在构造函数里创建子控件、设置属性、连接信号槽。 - main 函数:创建
QApplication→ 创建窗口对象(通常在栈上)→show()→app.exec()。
关于"窗口对象在栈上还是堆上":在 main 里写在栈上(MyWindow w;)是安全的,因为 app.exec() 返回后它就析构了,此时程序即将结束。但如果你在某个函数里创建窗口并 show(),就必须用堆(new),否则函数返回时窗口立刻销毁、一闪而过。这是初学者第二个常犯的错误。
还有一种更实用的做法是让堆上的窗口在关闭时自动释放:
// 关闭窗口时自动释放内存,避免内存泄漏且不依赖父对象
auto *w = new MyWindow;
w->setAttribute(Qt::WA_DeleteOnClose);
w->show();Qt::WA_DeleteOnClose 告诉 Qt:当这个窗口收到关闭事件并完成关闭后,把它 delete 掉。这在处理多个独立窗口(比如打开若干个子对话框)时非常有用。注意这种情况下不要再给它设置 parent,否则会导致析构两次。
#小结
main必须写成int main(int argc, char *argv[]),且创建QApplication(Widgets 程序)、QGuiApplication(无 Widgets)或QCoreApplication(控制台)。QWidget是一切控件的基类:parent 为空即顶层窗口,有 parent 即子控件。show()只是标记可见,真正的绘制与交互发生在app.exec()启动的事件循环里;exec()阻塞直到程序退出。qDebug()是 Qt 专用的链式调试输出,支持所有 Qt 类型的自动格式化。- 栈上创建窗口只在
main中安全;其他位置用new并配合Qt::WA_DeleteOnClose。
#练习
- 把示例改成继承
QMainWindow,对比窗口外观的变化(提示:暂时不放中央部件,看看会怎样)。 - 在窗口里再加一个
QPushButton,点击后调用close()关闭窗口;再试着重写closeEvent()弹出确认(提示:QMessageBox::question)。 - 写一个程序,创建 3 个独立窗口并全部
show(),观察"关闭最后一个窗口时程序才退出"的行为;查阅文档确认决定这一行为的是哪个属性。 - 思考并写下:
app.exec()阻塞期间,如果用std::thread启动一个工作线程,它会不会也被阻塞?为什么?(为后面的多线程与信号槽跨线程通信做铺垫)