QC++ / Qt 学习之路

第一个 Qt Widgets 程序

从 main 函数到事件循环,拆解 Qt 程序的骨架

入门第 17 / 48 章第三篇 · Qt 入门

#一个最小的窗口程序

上一章末尾我们跑起来了一个只有一个按钮的程序。这一章把它拆开,逐行搞清楚"为什么必须这么写"。先看一个更规范的版本——创建一个自己的窗口类,而不是直接在 main 里摆控件:

C++
// 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); 这一行做了四件大事:

  1. 构造应用程序对象,它是整个程序的单例管理者,保存全局状态(如字体、调色板、样式)。
  2. 解析命令行参数,处理 Qt 自己的选项(-style fusion、-platform 等)。
  3. 初始化窗口系统与资源,建立与操作系统 GUI 子系统的连接。在 Linux 上它会连接 X11 或 Wayland;在 macOS 上建立 NSApplication。
  4. 准备事件循环,为后面的 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),直到程序收到退出信号(通常是最后一个窗口被关闭)才返回。事件循环本质上就是一个无限循环:

Text
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 相当于零配置的 print 但自带 Qt 类型的格式化能力——这一点很像 Python 的 print 能直接打印 list 和 dict,而 C++ 的 std::cout 做不到。

#完整的 CMakeLists.txt

把上一章的 CMake 配置补全,加入多文件支持(这是你接下来所有示例的模板):

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 程序都是这个形状:

  1. 包含头文件:#include <QApplication> 加上你用到的控件。
  2. 定义窗口类:继承 QWidget 或 QMainWindow,在构造函数里创建子控件、设置属性、连接信号槽。
  3. main 函数:创建 QApplication → 创建窗口对象(通常在栈上)→ show() → app.exec()。

关于"窗口对象在栈上还是堆上":在 main 里写在栈上(MyWindow w;)是安全的,因为 app.exec() 返回后它就析构了,此时程序即将结束。但如果你在某个函数里创建窗口并 show(),就必须用堆(new),否则函数返回时窗口立刻销毁、一闪而过。这是初学者第二个常犯的错误。

还有一种更实用的做法是让堆上的窗口在关闭时自动释放:

C++
// 关闭窗口时自动释放内存,避免内存泄漏且不依赖父对象
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。

#练习

  1. 把示例改成继承 QMainWindow,对比窗口外观的变化(提示:暂时不放中央部件,看看会怎样)。
  2. 在窗口里再加一个 QPushButton,点击后调用 close() 关闭窗口;再试着重写 closeEvent() 弹出确认(提示:QMessageBox::question)。
  3. 写一个程序,创建 3 个独立窗口并全部 show(),观察"关闭最后一个窗口时程序才退出"的行为;查阅文档确认决定这一行为的是哪个属性。
  4. 思考并写下:app.exec() 阻塞期间,如果用 std::thread 启动一个工作线程,它会不会也被阻塞?为什么?(为后面的多线程与信号槽跨线程通信做铺垫)
我的学习笔记笔记总览
笔记保存在本机浏览器(localStorage),换设备或清理缓存会丢失;重要内容请点「导出全部笔记」存成 .md 文件。