Qt学习第一个程序：Hello，World

本文将以Qt 5/6（通用步骤，两者无核心差异）、Qt Creator开发工具为例，完成经典的Hello，World程序，包含纯代码编写和UI拖拽两种方式，步骤详细且适合零基础入门，确保每一步都能落地执行。

前置准备

1. 安装Qt开发环境：需包含Qt Creator编辑器、对应版本的Qt库（如5.15.2/6.6.0）、MinGW编译器（推荐，无需额外配置）。

2. 验证环境：打开Qt Creator，无报错弹窗即表示环境正常。

方式一：纯代码编写（控制台版Hello，World）

适合理解Qt的程序入口、工程结构，无图形界面，运行后在控制台输出文字。

步骤1：新建Qt控制台工程

1. 打开Qt Creator，点击文件(F) → 新建文件或项目(N)。

2. 在弹出的窗口中，选择项目 → Application → Qt Console Application，点击选择(C)。

3. 工程命名：输入 HelloWorld_Console （建议英文，无空格/中文），选择工程保存路径，点击下一步。

4. 构建套件选择：勾选已安装的MinGW（如MinGW 8.1.0 64-bit），点击下一步。

5. 类信息：默认类名 Main 、基类 QCoreApplication ，无需修改，点击下一步。

6. 点击完成，自动生成控制台工程结构。

步骤2：编写核心代码

工程生成后，自动打开 main.cpp 文件，替换原有代码为以下内容（注释已标注核心逻辑）：

// 引入Qt核心头文件，QCoreApplication是控制台程序的核心类，处理应用程序事件循环

#include <QCoreApplication>

// 引入输入输出头文件，用于控制台打印（Qt的qDebug替代C++的cout，跨平台性更好）

#include <QDebug>

int main(int argc, char *argv[])

{

// 创建Qt应用程序对象，argc和argv是命令行参数，Qt程序必须有且仅有一个该对象

QCoreApplication a(argc, argv);

// 控制台输出Hello，World，qDebug()自动换行，无需加\n

qDebug() << "Hello，World！";

// 启动应用程序的事件循环（控制台程序可省略，此处为规范写法，兼容Qt语法）

return a.exec();

}

步骤3：运行程序

1. 点击Qt Creator左上角构建按钮（锤子图标），或按快捷键Ctrl+B，编译工程（底部编译栏显示 0 errors, 0 warnings 即编译成功）。

2. 点击运行按钮（绿色三角图标），或按快捷键Ctrl+R，底部应用程序输出栏将显示： Hello，World！ ，控制台版程序完成。

方式二：图形界面版Hello，World（带窗口/文字）

更贴合Qt的GUI开发特性，生成带窗口的程序，窗口中显示Hello，World文字，包含纯代码创建界面和UI拖拽两种子方式，推荐新手先学UI拖拽，快速感受Qt的可视化开发。

子方式1：UI拖拽版（可视化开发，无复杂代码）

步骤1：新建Qt Widgets工程

1. 点击文件(F) → 新建文件或项目(N)，选择项目 → Application → Qt Widgets Application，点击选择(C)。

2. 工程命名： HelloWorld_GUI ，选择保存路径，点击下一步。

3. 构建套件勾选MinGW，点击下一步。

4. 类信息配置（核心）：

- 类名：默认 MainWindow （主窗口类，可自定义如 HelloWindow ）。

- 基类：选择 QMainWindow （带菜单栏/工具栏的主窗口，新手推荐），也可选择 QWidget （空白基础窗口）。

- 勾选创建界面（必须勾选，否则无UI编辑界面），点击下一步。

5. 点击完成，生成图形界面工程，自动打开UI编辑界面（右侧为控件栏，中间为窗口画布，左侧为对象树）。

步骤2：UI拖拽添加文字控件

1. 右侧控件栏，找到Display Widgets（显示控件）分类，选择QLabel（标签控件，用于显示文字/图片）。

2. 按住QLabel拖拽到中间的窗口画布中，松开鼠标，画布中出现一个默认文字为 TextLabel 的标签。

3. 双击画布中的 TextLabel ，进入编辑模式，删除原有文字，输入 Hello，World！ ，按回车确认。

4. 可选：拖动标签边缘调整大小，或在右侧属性编辑器中修改文字样式：

- font ：设置字体、字号（如宋体，20号）。

- alignment ：设置文字居中（水平+垂直居中）。

- styleSheet ：设置文字颜色（如 color: red; ）。

步骤3：直接运行程序

无需编写任何代码，直接点击构建(Ctrl+B) → 运行(Ctrl+R)，将弹出一个带窗口的程序，窗口中显示设置好的 Hello，World！ 文字，图形界面版完成。

子方式2：纯代码创建图形界面（理解Qt界面底层逻辑）

基于上述Qt Widgets工程，不使用UI拖拽，纯代码创建窗口和标签，步骤如下：

步骤1：新建Qt Widgets工程（取消UI）

1. 按上述方式新建 HelloWorld_GUI_Code 工程，在类信息步骤中，取消勾选创建界面，点击完成。

2. 工程生成后，核心文件为 mainwindow.h （头文件）、 mainwindow.cpp （实现文件）、 main.cpp （程序入口）。

步骤2：编写头文件（mainwindow.h）

打开 mainwindow.h ，添加QLabel的头文件引入和声明，代码如下：

cpp

#ifndef MAINWINDOW_H

#define MAINWINDOW_H

#include <QMainWindow>

// 引入QLabel头文件，使用标签控件

#include <QLabel>

class MainWindow : public QMainWindow

{

Q_OBJECT // Qt的元对象宏，必须有，支持信号与槽机制

public:

MainWindow(QWidget *parent = nullptr); // 构造函数

~MainWindow(); // 析构函数

};

#endif // MAINWINDOW_H

步骤3：编写实现文件（mainwindow.cpp）

打开 mainwindow.cpp ，在构造函数中创建QLabel并设置属性，代码如下：

#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent)

: QMainWindow(parent)

{

// 1. 设置主窗口的标题和大小

this->setWindowTitle("Qt HelloWorld"); // 窗口标题

this->resize(400, 300); // 窗口大小：宽400像素，高300像素

// 2. 创建QLabel标签对象，父对象设为当前主窗口（自动随窗口显示/销毁）

QLabel *label = new QLabel(this);

// 3. 设置标签显示的文字

label->setText("Hello，World！");

// 4. 设置标签的大小和位置（x:100, y:100为左上角坐标，宽200，高50）

label->setGeometry(100, 100, 200, 50);

// 5. 可选：设置文字居中、字体

label->setAlignment(Qt::AlignCenter); // 文字水平+垂直居中

QFont font;

font.setFamily("宋体"); // 字体

font.setPointSize(20); // 字号

label->setFont(font);

}

MainWindow::~MainWindow()

{

// 父对象为MainWindow，Qt自动管理内存，无需手动释放label

}

步骤4：运行程序

构建（Ctrl+B）→ 运行（Ctrl+R），将弹出一个自定义标题、大小的窗口，窗口中显示居中的 Hello，World！ 文字，纯代码图形界面完成。

核心知识点解析（新手必看）

1. Qt程序入口：所有Qt程序的入口都是 main() 函数，必须创建QApplication（图形界面）/QCoreApplication（控制台）对象，且仅有一个。

2. 事件循环： a.exec() 是Qt的事件循环入口，图形界面程序必须有，用于处理窗口的点击、刷新等事件；控制台程序可省略。

3. 跨平台性：上述代码无需修改，可在Windows、Linux、macOS上编译运行，Qt自动处理底层系统差异。

4. 内存管理：Qt中为控件设置父对象后，父对象销毁时会自动销毁子对象，无需手动 delete ，避免内存泄漏。

5. 核心头文件：

- QCoreApplication ：控制台程序核心。

- QApplication ：图形界面程序核心（继承自QCoreApplication，自动引入）。

- QLabel ：标签控件，用于显示文字。

- QMainWindow/QWidget ：窗口基类，所有图形界面都基于此。

常见问题排查

1. 编译报错 error: undefined reference to xxx ：未勾选对应构建套件，或Qt库未正确安装，重新打开Qt维护工具安装对应库。

2. 运行无窗口/无输出：图形界面程序忘记创建应用程序对象，或未调用 exec() ；控制台程序未引入 QDebug 。

3. UI拖拽后运行无文字：未修改QLabel的默认文字，或控件被窗口边缘遮挡，调整控件位置。