1. 创建第一个Qt窗口

创建第一个Qt窗口 学习卡片

任务目标

使用 Qt Widgets 模块创建一个最小可运行的图形窗口程序。窗口包含一个文本标签,显示内容为“Hello, Qt!”。通过本案例,验证 Qt 开发环境是否配置正确,并掌握 Qt 项目的基本结构。

环境与依赖

  • Qt 5.15 或 Qt 6.x(Widgets 模块)
  • 编译器:支持 C++11 或更高版本(如 MSVC、MinGW、Clang)
  • 构建工具:qmake 或 CMake(本案例使用 qmake)

完整实现

创建项目目录 first_qt_window,在其中新建以下两个文件:

first_qt_window.pro(qmake 项目文件):

QT += widgets
TARGET = first_qt_window
TEMPLATE = app
SOURCES += main.cpp

main.cpp(程序入口):

#include <QApplication>
#include <QLabel>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QLabel label("Hello, Qt!");
    label.resize(240, 80);
    label.show();

    return app.exec();
}

运行方式

  1. 在终端进入 first_qt_window 目录,执行 qmake 生成 Makefile;
  2. 执行 make(Windows 下若使用 MinGW 则为 mingw32-make)编译项目;
  3. 运行生成的可执行文件 first_qt_window(Windows 下为 first_qt_window.exe)。

验证方法

程序启动后,屏幕上应出现一个标题为 first_qt_window 的窗口,窗口中央显示文本 Hello, Qt!。窗口大小约为 240×80 像素,可正常关闭。若窗口正常显示且无编译错误,则说明 Qt Widgets 环境配置正确,案例通过。

first_qt_window × Hello, Qt! QLabel 文本 窗口标题

上图展示了程序运行后的预期窗口布局:外层为应用主窗口,标题栏显示项目名称,中央区域为 QLabel 控件及其显示的文本内容。