第一个 Qt 项目Hello World 的完整拆解——从 main 函数到事件循环引言在上一篇文章中我们成功搭建了 Qt 开发环境点击运行按钮看到了一个空白的窗口弹出。但对于一个 C 开发者来说仅仅“让程序跑起来”是远远不够的。真正值得思考的问题是那几行自动生成的代码到底在背后做了什么#includeQApplication#includemainwindow.hintmain(intargc,char*argv[]){QApplicationa(argc,argv);MainWindow w;w.show();returna.exec();}这段代码只有短短 7 行。但如果你把这几行代码当做一个“黑盒”来使用你就错过了 Qt 中最核心、最基础的设计思想。在这一篇中我们不急着去写复杂的界面而是把这几行代码彻底拆解清楚。我们会依次回答以下几个问题argc和argv能做什么——命令行参数与 Qt 应用。QApplication到底是什么它和QCoreApplication有什么区别w.show()真的把窗口“显示”出来了吗a.exec()为什么不会让程序立刻退出事件循环到底在做什么这个过程中MOC元对象编译器悄然参与了哪一步当你理解了这几行代码的每一层含义之后你才算真正入了 Qt 的门。一、从 main 函数的参数说起命令行应用与 GUI 应用任何 C 程序的入口都是main函数。它的两个参数——argc参数个数和argv参数值数组——经常被初学者忽略。但在现实工程中命令行参数非常重要。例如# 以调试模式启动./myapp--debug# 打开特定文件./myapp D:/Projects/demo.txt# 无界面模式用于自动化测试./myapp--headlessQt 提供了非常优雅的方式来处理这些参数而这就是QApplication构造函数的隐藏能力之一。默认行为Qt 自动处理标准命令行选项当我们构造QApplication时Qt 会自动解析一些标准命令行选项。例如命令行参数作用-stylewindows强制使用 Windows 风格-stylefusion强制使用 Fusion 风格-reverse设置布局方向为从右到左-qmljsdebugger...启用 QML 调试这些参数不需要你写任何额外代码Qt 在构造QApplication时就已经帮你处理好了。一个容易忽略的细节Qt 可能会修改 argc 和 argvQApplication构造时会检查命令行参数并处理 Qt 自己认识的参数。因此传入QApplication的argc和argv并不一定会保持原样。这也是为什么 Qt 官方建议如果程序自己还需要解析命令行参数通常应该先构造QApplication再使用QCommandLineParser处理业务参数。Qt 还提供QCommandLineParser处理自定义参数这部分会在后续工程化章节介绍。二、QApplication 和它的兄弟姐妹们接下来我们来看QApplication a(argc, argv);这一行。很多人在写这一行代码时只是把它当做“启动 Qt 的魔法咒语”。但实际上QApplication在一个 Qt 程序中承担着非常重要的职责。QApplication 在做什么当构造QApplication对象时Qt 会完成 QWidget 应用所需要的初始化工作包括初始化应用程序相关的 GUI 环境根据系统设置初始化字体、调色板等初始化 QWidget 相关功能创建并准备应用程序级事件处理环境解析 Qt 支持的部分标准命令行参数管理应用程序中的顶层窗口、剪贴板、鼠标指针等全局 GUI 状态。真正进入主事件循环则是在后面的app.exec()中完成。Qt 的三种“应用”类型实际上Qt 提供了三个层级不同的 Application 类它们的继承关系如下QCoreApplication (无 GUI纯命令行/服务) ↑ QGuiApplication (GUI 基础设施但不提供 QWidget) ↑ QApplication (在 QGuiApplication 基础上增加 QWidget 支持)这三者的选择非常简单类名适用场景QCoreApplication纯控制台应用、后台服务、批处理程序不需要任何 GUI 功能。QGuiApplication使用 Qt Quick / QML 或纯 OpenGL 构建的应用不依赖 Qt Widgets 模块。QApplication使用 QWidget、QMainWindow 和传统 Qt 控件的桌面应用。下面这种组合方式能使用吗QCoreApplication app(argc, argv); QWidget widget;答案当然是不能。Widget属于 Qt Widgets 模块需要QApplication提供对应的初始化环境。因此对于 QWidget 应用程序应该使用QApplication而不是QCoreApplication。可以简单理解为QCoreApplication ↓ 基础事件循环和应用程序环境 QGuiApplication ↓ 增加 GUI 基础能力 QApplication ↓ 增加 QWidget 所需要的能力生命周期问题为什么通常把 QApplication 放在栈上你可能会想到QApplication *app new QApplication(argc, argv);这种写法并不是绝对错误。但 Qt 示例以及实际工程中通常直接使用QApplication app(argc, argv);原因是 C 的 RAII 机制可以自动管理它的生命周期。当main()结束时app.exec() ↓ 事件循环退出 ↓ main() 返回 ↓ QApplication 自动析构 ↓ Qt 清理应用程序相关资源因此对于生命周期与main()一致的对象栈对象是更加自然的选择在 Qt 的官方规范中QCoreApplication及其子类必须在main函数中构造并且在main函数返回之前不能析构。栈对象自动满足了这一要求。三、w.show() 到底做了什么很多人想当然地以为w.show()就是把窗口“画”到屏幕上。从逻辑上说没错。但从实现角度来说show()做了远比“绘图”复杂得多的事情。show()的核心工作流程如下创建底层窗口句柄Windows 上的HWNDLinux X11 上的Window。将 Qt 窗口QWidget或QMainWindow与操作系统原生窗口关联。show()会使 QWidget 进入可见状态并在需要时创建/显示对应的原生窗口资源。窗口显示后Qt 的事件系统会根据需要产生并处理绘制事件最终由 QWidget 的绘制机制完成界面绘制。关键认知show()只是把窗口映射到屏幕上并标记为“需要绘制”。真正的绘制动作是在事件循环运行之后由QPaintEvent触发的。也就是说如果在调用w.show()之后立即调用return 0;不进入事件循环程序会直接退出你甚至看不到窗口闪现——因为它还没来得及处理绘制事件。对于一个正常的 Qt GUI 应用程序来说show()通常需要配合app.exec()使用。show()负责让窗口进入可见状态而exec()负责进入应用程序的主事件循环使程序能够持续处理用户输入、窗口系统事件、定时器等事件。四、事件循环深入理解 a.exec()这是 Qt 初学者最难理解、但却最重要的概念。什么是事件循环通俗地说事件循环是一个无限循环它不断地从“事件队列”中取出事件并将其分发给对应的对象进行处理。它的伪代码逻辑大致如下以下代码只是帮助理解事件循环的伪代码并不是 Qtexec()的实际源码。intexec(){while(!exitRequested){Event eventwaitForNextEvent();dispatchEvent(event);}returnexitCode;}为什么需要事件循环如果没有事件循环我们的程序会瞬间执行完毕并退出。有了事件循环程序会一直运行等待并处理各种事件例如鼠标点击、键盘输入、窗口缩放、定时器事件以及网络 I/O 相关事件。用现实世界的例子来理解例子一餐厅服务员想象一个餐厅服务员他站在门口等待客人进来等待事件客人进来后他引导客人入座并记录点单处理事件点单完成后他又回到门口等待下一位客人回到循环。这个服务员不会因为“处理完一桌客人”就下班。他会持续不断地等待、处理、再等待。操作系统的事件循环或者说 Qt 的事件循环就是这样一个“服务员”。它永远不会主动停止除非你告诉它“打烊了”调用quit()。例子二邮件客户端当你打开 Outlook 或 Foxmail 时程序不会运行 1 秒就退出它持续运行等待你点击“收件箱”它持续运行等待邮件到达的通知网络事件它持续运行等待你双击一封邮件。这种“一直在等着随时准备响应”的机制就是事件循环。事件循环是阻塞的但不是“死”的初学者常常会疑惑a.exec()阻塞了主线程那程序为什么还能响应点击和动画关键在于a.exec()的阻塞是一种“主动等待”而不是“忙等”。忙等while(true) { check(); }—— 持续占用 CPU导致 CPU 使用率 100%。主动等待waitForEvent()—— 将线程挂起操作系统在没有事件时不会分配给该线程 CPU 时间片只有当鼠标移动、键盘敲击或定时器超时等事件发生时操作系统才会唤醒该线程。“阻塞”描述的是main()这一调用路径没有继续向下执行并不意味着主线程停止工作。例如return app.exec(); qDebug() 这里什么时候执行;答案是exec()返回之后才会执行。但在exec()内部主线程 ↓ 事件循环 ├── 鼠标事件 ├── 键盘事件 ├── Paint事件 ├── Timer事件 ├── Socket事件 └── ...所以主线程被exec()阻塞 ≠ 主线程什么都不干。这种机制不仅高效而且让 GUI 程序能够在单线程模式下平滑运行——所有 UI 操作在主线程串行执行不需要复杂的锁机制这也是 Qt 要求 UI 操作必须在主线程的根本原因之一。exec() 什么时候退出exec()会一直运行直到以下情况发生调用了QCoreApplication::quit()当最后一个可见的顶层窗口关闭时Qt 默认会根据quitOnLastWindowClosed的设置退出应用程序事件循环。用户强制终止进程。exec()的返回值是一个int代表退出代码。在脚本或自动化测试中这个退出码可以用来判断程序是正常退出还是异常终止。五、链接与 MOC构建过程中看不见的工作这一节虽然是入门篇但既然我们第一篇就聊了 Qt 与 C 的关系这里需要提一下构建过程中的幕后工作。我们在第二篇中提到使用 CMake 构建时编译输出中会出现autogen/moc_compilation.cpp.obj。在 Hello World 中MOC 参与了吗答案是参与了但只参与了一点点。在我们前面使用 Qt Creator 创建的典型 Widgets 项目中MainWindow通常包含Q_OBJECT因此 CMake 的 AUTOMOC 会在构建过程中调用 MOC。但需要注意并不是所有 Qt 程序都必须使用 MOC。MOC 是针对使用 Qt 元对象扩展的类而存在的典型判断标志就是类声明中的Q_OBJECT等宏MainWindow类定义中包含了Q_OBJECT宏class MainWindow : public QMainWindow { Q_OBJECT // ... };这个宏告诉 MOC这个类需要元对象信息。MOC 在预处理阶段读取mainwindow.h生成一个额外的 C 源文件例如moc_mainwindow.cpp其中包含了MainWindow的元对象表QMetaObject和信号/槽的索引信息。但在 Hello World 这个阶段MainWindow 并没有定义任何自定义信号或槽。为什么还需要 MOC因为QMainWindow本身从QObject继承而Q_OBJECT宏的另一个作用是启用动态属性、运行时类型信息inherits()、metaObject()等。有一个需要明确QObject本身并不要求你的每一个派生类都写Q_OBJECT例如class MyObject : public QObject { };这个类仍然是QObject派生类。但是class MyObject : public QObject { Q_OBJECT };才会让这个派生类本身拥有由 MOC 生成的完整元对象信息例如自己声明的 signalsslotsproperties自己的元对象信息动态类型相关能力等Qt 官方对 MOC 的定位也是读取包含Q_OBJECT的类声明并生成元对象代码这些元对象代码用于信号槽、运行时类型信息、动态属性系统等。这也是为什么 Qt 强调任何从 QObject 派生的类只要需要信号槽、属性或运行时类型信息就必须在类声明中包含Q_OBJECT宏否则 MOC 将跳过它。六、对象生命周期从创建到析构到这里我们已经知道int main(int argc, char *argv[]) { QApplication app(argc, argv); MainWindow w; w.show(); return app.exec(); }但还有一个非常重要的问题app和w是什么时候创建的什么时候销毁的这其实涉及 C 中非常基础、也非常重要的一个概念——对象生命周期。QApplication 和 MainWindow 是什么时候创建的程序进入main()后按照代码执行顺序QApplication app(argc, argv);首先创建QApplication对象。然后MainWindow w;创建MainWindow对象。因此可以简单理解为进入 main() ↓ 创建 QApplication ↓ 创建 MainWindow ↓ 显示 MainWindow ↓ 进入事件循环此时两个对象都处于存活状态main() │ ├── QApplication app │ └── MainWindow wexec() 并不会销毁这些对象执行return app.exec();以后程序进入事件循环。此时MainWindow w;这个对象仍然存在。app.exec()并不会创建一个新的MainWindow也不会销毁MainWindow。它只是让当前线程进入事件循环不断处理鼠标事件 键盘事件 绘制事件 定时器事件 窗口事件 网络 I/O 事件 ……所以在事件循环运行期间可以理解为QApplication app ────────────────┐ │ MainWindow w ───────────────┐ │ │ │ app.exec() │ │ 事件循环运行 │ │ │ │ 用户不断操作 │ │ │ │exec() 返回以后发生什么当应用程序退出时事件循环结束app.exec()返回一个整数退出码。例如int exitCode app.exec(); return exitCode;这时候程序才会继续执行main()后面的代码。对于return app.exec();可以理解成int exitCode app.exec(); return exitCode;当return执行以后main()开始结束。这时 C 会自动销毁main()中创建的局部对象。C 对象是按照什么顺序析构的这里有一个非常重要的 C 规则局部对象按照创建顺序构造按照创建顺序的逆序析构。我们的代码是QApplication app(argc, argv); MainWindow w;所以构造 QApplication ↓ MainWindow 析构 MainWindow ↓ QApplication也就是说MainWindow是后创建的所以它会先析构。完整过程可以理解为程序启动 ↓ 创建 QApplication ↓ 创建 MainWindow ↓ w.show() ↓ app.exec() ↓ 事件循环运行 ↓ 用户关闭程序 ↓ exec() 返回 ↓ main() 返回 ↓ MainWindow 析构 ↓ QApplication 析构 ↓ 程序退出为什么这个顺序很重要因为MainWindow属于 Qt GUI 对象而QApplication是整个 Qt GUI 应用程序环境。因此在正常的生命周期设计中QApplication │ └── MainWindow应该保证QApplication 的生命周期覆盖整个 GUI 对象的生命周期。这也是为什么通常把QApplication app(argc, argv);放在main()的最前面并让它一直存活到main()结束。再结合对象树理解Qt 还有一个非常重要的机制——QObject 父子对象树。例如QWidget parent; QPushButton button(parent);这里button的父对象是parent。当parent被销毁时Qt 的 QObject 对象树机制会自动处理它的子对象。因此Qt 中实际上存在两套需要同时理解的生命周期机制C 生命周期 ↓ 局部对象 / 栈对象 / 析构顺序 Qt 对象树 ↓ QObject 父子关系 / 子对象自动销毁这两个概念并不是一回事。理解它们之后后面学习QWidget 父子关系QObject 对象树动态创建控件deleteLater()Qt 内存管理都会更加容易。用一句话总结对于最基本的 Qt Widgets 程序可以记住这条生命周期创建 QApplication ↓ 创建 MainWindow ↓ 显示窗口 ↓ 进入事件循环 ↓ 用户持续操作 ↓ 事件循环退出 ↓ MainWindow 析构 ↓ QApplication 析构 ↓ 程序结束这就是一个最简单 Qt GUI 程序从启动、运行到退出的完整生命周期。七、为什么 main() 不能直接 return 0到这里我们已经知道MainWindow w; w.show();会让窗口进入可见状态。那么一个很自然的问题来了既然窗口已经show()了为什么不能直接return 0例如下面这样的代码为什么不行int main(int argc, char *argv[]) { QApplication app(argc, argv); MainWindow w; w.show(); return 0; }代码确实可以编译但程序几乎马上就结束首先要明确一点这段代码本身并不一定编译报错。真正的问题发生在运行时。程序的执行过程是进入 main() ↓ 创建 QApplication ↓ 创建 MainWindow ↓ 调用 w.show() ↓ 窗口进入可见状态 ↓ 执行 return 0 ↓ main() 结束 ↓ w 析构 ↓ app 析构 ↓ 进程退出也就是说show()并不会让程序一直运行。它只是让窗口进入可见状态。为什么 show() 不能让程序一直运行因为show()和“程序持续运行”其实是两件不同的事情。例如w.show();解决的是窗口应该显示出来。而app.exec();解决的是程序接下来应该持续运行并不断处理事件。可以把它们理解成show() ↓ 让窗口“出现” exec() ↓ 让程序“活着”因此w.show(); return 0;相当于把窗口打开 ↓ 立刻关掉整个程序那么 return app.exec() 到底解决了什么正确的代码是int main(int argc, char *argv[]) { QApplication app(argc, argv); MainWindow w; w.show(); return app.exec(); }这里最关键的是app.exec();它会进入 Qt 的主事件循环。可以把它简单理解成while (程序没有要求退出) { 等待事件; 获取事件; 将事件分发给对应对象; 处理事件; }当然这只是为了帮助理解的伪代码并不是 Qt 内部实际源码。运行起来以后到底发生了什么假设我们启动程序main() ↓ QApplication ↓ MainWindow ↓ w.show() ↓ app.exec()进入exec()后程序不会退出。此时事件循环开始工作app.exec() │ ▼ ┌──────────────┐ │ 等待事件 │ └──────┬───────┘ │ 收到一个事件 ↓ 获取这个事件 ↓ 分发给目标对象 ↓ 对象处理事件 ↓ 回到事件循环 ↓ 等待下一个事件例如用户移动鼠标用户移动鼠标 ↓ 操作系统产生鼠标相关事件 ↓ Qt 事件循环获取事件 ↓ 找到对应的 QWidget ↓ 调用相应的事件处理函数 ↓ 继续等待下一个事件用户点击按钮用户点击按钮 ↓ 操作系统产生鼠标事件 ↓ Qt 事件循环 ↓ QPushButton ↓ 处理鼠标事件 ↓ 可能发出 clicked() 信号 ↓ 连接的槽函数执行所以exec()运行期间主线程实际上一直在工作。“exec() 阻塞了主线程”为什么窗口还能够响应这是初学者非常容易产生误解的地方。我们经常说app.exec()会阻塞当前线程。这里的“阻塞”并不是主线程什么都不做。而是main()后面的代码不会继续执行直到事件循环退出。例如qDebug() A; int result app.exec(); qDebug() B;程序运行后输出 A ↓ 进入事件循环 ↓ 程序持续运行 ↓ 用户操作窗口 ↓ 处理各种事件 ↓ …… ↓ 事件循环退出 ↓ exec() 返回 ↓ 输出 B所以main() 的执行流程被暂停 ≠ 主线程停止工作更准确地说main() │ ├── 前面的代码正常执行 │ ├── app.exec() │ │ │ └── 主线程进入事件循环 │ ├── 等待事件 │ ├── 处理事件 │ ├── 等待事件 │ └── 处理事件 │ └── exec() 返回后继续执行那么什么时候 exec() 才会返回只有当应用程序收到退出请求时事件循环才会结束。例如QApplication::quit();或者QCoreApplication::quit();也可以通过QApplication::exit(0);退出事件循环。对于普通 Qt Widgets 程序当最后一个顶层窗口关闭时Qt 默认也会让应用程序退出。因此用户关闭窗口 ↓ 关闭事件被处理 ↓ 应用程序请求退出 ↓ 事件循环结束 ↓ exec() 返回 ↓ main() 返回 ↓ 局部对象析构 ↓ 程序退出用一个最直观的例子理解错误示例int main(int argc, char *argv[]) { QApplication app(argc, argv); MainWindow w; w.show(); return 0; }可以理解成创建程序 ↓ 创建窗口 ↓ 显示窗口 ↓ 程序立即退出正确示例int main(int argc, char *argv[]) { QApplication app(argc, argv); MainWindow w; w.show(); return app.exec(); }则是创建程序 ↓ 创建窗口 ↓ 显示窗口 ↓ 进入事件循环 ↓ 等待用户操作 ↓ 处理事件 ↓ 继续等待 ↓ …… ↓ 用户关闭程序 ↓ 退出事件循环 ↓ main() 返回 ↓ 程序退出记住 show() 和 exec() 的区别这是理解 Qt 程序启动流程最重要的一组概念代码主要作用MainWindow w;创建窗口对象w.show();让窗口进入可见状态app.exec();进入 Qt 主事件循环app.quit();请求退出事件循环exec()返回事件循环已经结束因此一个最基本的 Qt Widgets 程序才会写成int main(int argc, char *argv[]) { QApplication app(argc, argv); MainWindow w; w.show(); return app.exec(); }这几行代码实际上分别解决了三个不同的问题QApplication ↓ 建立 Qt GUI 应用环境 MainWindow show() ↓ 创建并显示窗口 app.exec() ↓ 让程序进入事件循环持续处理事件这就是为什么return 0不能替代return app.exec()。完整声明周期流程图让我们把所有的拼图组合起来看看一个完整的 Hello World 程序从启动到窗口关闭经历了怎样的时序从这张图可以看出QApplication、MainWindow和事件循环三者之间是如何协同工作的。八、总结Hello World 教会我们的三件事回顾这一篇的内容一个看似简单的 Hello World 程序实际上教会了我们三件非常重要的事情。第一件事Qt 应用是有“生命”的QApplication对象是程序的“心脏”。它在构造时启动整个框架在析构时清理所有资源。第二件事GUI 程序的核心是事件循环没有事件循环窗口只是静态的图片有了事件循环窗口才有了“生命”——能够响应点击、输入、缩放和网络事件。这也是为什么a.exec()是 Qt 程序与普通 C 控制台程序最大的不同之处。第三件事MOC 是 Qt 元对象系统的重要组成部分MOC 为带有 Qt 元对象声明的类生成额外的 C 代码从而支持信号与槽、运行时类型信息、属性系统等机制。当你理解了这几行代码背后的机制后续所有的 Qt 学习都会变得顺理成章。学习信号与槽时你会知道那是 MOC 生成的元对象在发挥作用学习多线程时你会知道为什么不能在工作线程直接操作 UI因为事件循环在主线程学习网络编程时你会知道网络事件也是通过事件循环分发到QTcpSocket的。对于本篇的一些关键词非常容易混淆下表可以先简单进行理解概念负责什么QApplicationQWidget 应用程序环境show()让窗口进入可见状态exec()进入主事件循环EventQt 中传递/处理的事件SignalQt 对象之间的通知机制Slot接收信号并执行相应逻辑Q_OBJECT为类启用 Qt 元对象相关能力MOC为Q_OBJECT等 Qt 元对象声明生成代码QObjectQt 对象模型的基础类这就是“从根源理解”和“只背 API”之间的区别。从下一篇开始我们将正式进入 Qt 的核心控件和基础组件学习。但我们不会像普通教程那样简单地罗列 “QPushButton 有哪些属性”。我们会带着一个更深入的问题去学习这些控件是如何与事件循环、对象树和元对象系统协同工作的下一篇预告《Qt 项目构建流程深度解析——MOC、UIC、RCC 的作用与原理》窗口才有了“生命”——能够响应点击、输入、缩放和网络事件。这也是为什么a.exec()是 Qt 程序与普通 C 控制台程序最大的不同之处。第三件事MOC 是 Qt 元对象系统的重要组成部分MOC 为带有 Qt 元对象声明的类生成额外的 C 代码从而支持信号与槽、运行时类型信息、属性系统等机制。当你理解了这几行代码背后的机制后续所有的 Qt 学习都会变得顺理成章。学习信号与槽时你会知道那是 MOC 生成的元对象在发挥作用学习多线程时你会知道为什么不能在工作线程直接操作 UI因为事件循环在主线程学习网络编程时你会知道网络事件也是通过事件循环分发到QTcpSocket的。对于本篇的一些关键词非常容易混淆下表可以先简单进行理解概念负责什么QApplicationQWidget 应用程序环境show()让窗口进入可见状态exec()进入主事件循环EventQt 中传递/处理的事件SignalQt 对象之间的通知机制Slot接收信号并执行相应逻辑Q_OBJECT为类启用 Qt 元对象相关能力MOC为Q_OBJECT等 Qt 元对象声明生成代码QObjectQt 对象模型的基础类这就是“从根源理解”和“只背 API”之间的区别。从下一篇开始我们将正式进入 Qt 的核心控件和基础组件学习。但我们不会像普通教程那样简单地罗列 “QPushButton 有哪些属性”。我们会带着一个更深入的问题去学习这些控件是如何与事件循环、对象树和元对象系统协同工作的下一篇预告《Qt 项目构建流程深度解析——MOC、UIC、RCC 的作用与原理》