桌面应用 / 系统课时
创建第一个 Widgets 项目
创建第一个 Widgets 项目
本篇解决创建 Qt 桌面程序的第一个完整闭环问题。你将使用 Qt Creator 创建 Widgets Application,理解项目文件结构,完成构建并运行一个可以显示窗口的桌面应用。
学习目标
- 使用 Qt Creator 创建 Qt Widgets Application 项目
- 理解 Qt 项目中的源码、界面和构建文件职责
- 完成构建运行流程并验证窗口程序启动
创建 Qt Widgets Application
启动 Qt Creator 后选择创建新项目,选择桌面应用中的 Qt Widgets Application 模板。
创建过程中需要指定项目名称、保存路径、Qt 版本和 Kit。对于初学阶段,选择前一篇已经验证可用的默认 Kit 即可。
Qt Widgets 项目通常会生成入口代码、窗口类和项目配置文件。最小程序会通过 QApplication 创建应用对象,再显示主窗口。
编写第一个窗口程序
下面是一个最小 Widgets 示例。该示例依赖 Qt 6 Widgets 模块,程序启动后创建窗口并显示文本。
cpp
#include <QApplication>
#include <QLabel>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
// 创建一个简单控件作为窗口内容
QLabel label("Hello Qt 6");
label.resize(300, 100);
label.show();
return app.exec();
}预期结果
text
程序成功启动。
桌面上显示一个标题为 Hello Qt 6 内容区域的窗口。
关闭窗口后,应用进程结束。构建并运行项目
Qt Creator 会根据当前 Kit 生成构建配置。点击运行按钮后,IDE 会先编译源码,再启动生成的可执行文件。
也可以使用 Qt 提供的构建工具从项目目录执行构建。下面示例适用于已经配置好的 CMake 项目目录。
bash
cmake -S . -B build
cmake --build build预期输出
text
Build files have been written to: build
[100%] Built target <PROJECT_NAME>实际项目名称会替换 <PROJECT_NAME>,构建目录也可以根据项目设置调整。
理解项目文件作用
Qt 6 新项目通常使用 CMake 管理构建流程,常见文件职责如下:
| 文件 | 作用 |
|---|---|
| CMakeLists.txt | 定义项目、依赖和构建规则 |
| main.cpp | 程序入口 |
| 窗口类文件 | 管理界面逻辑 |
| .ui 文件 | Qt Designer 生成的界面描述 |
运行失败时的检查顺序
如果项目无法启动,可以按照以下顺序定位:
- 确认 Qt Kit 是否选择正确。
- 检查 CMake 是否找到 Qt 6 安装目录。
- 查看编译错误是否来自缺少模块或头文件。
- 确认程序入口包含 QApplication 并进入事件循环。
Qt Widgets 程序能够运行的关键不是窗口代码本身,而是 Qt 库、编译器和构建系统之间已经建立正确连接。
按自己的节奏,确认真正理解。