桌面应用 / 系统课时

创建第一个 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 生成的界面描述

运行失败时的检查顺序

如果项目无法启动,可以按照以下顺序定位:

  1. 确认 Qt Kit 是否选择正确。
  2. 检查 CMake 是否找到 Qt 6 安装目录。
  3. 查看编译错误是否来自缺少模块或头文件。
  4. 确认程序入口包含 QApplication 并进入事件循环。

Qt Widgets 程序能够运行的关键不是窗口代码本身,而是 Qt 库、编译器和构建系统之间已经建立正确连接。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建第一个 Widgets 项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通