用Qt创建首个GUI窗口需三步：初始化QApplication、定义继承QMainWindow的窗口类、调用show()显示窗口；需正确链接Qt6::Widgets模块并运行CMake构建。
用Qt创建第一个GUI窗口，核心是初始化应用、定义窗口类、显示窗口三步。不需要复杂配置，只要环境已安装Qt（推荐Qt 6 + CMake），就能快速跑起来。
1. 创建基础项目结构
新建一个空目录，比如 helloqt，在里面创建两个文件：
- main.cpp：程序入口，负责启动应用和显示窗口
-
mainwindow.h 和 mainwindow.cpp：自定义窗口类（继承
QMainWindow）
确保你的构建系统（如CMakeLists.txt）已正确链接 Qt6::Widgets 模块。
2. 编写主窗口类（mainwindow.h / mainwindow.cpp）
在 mainwindow.h 中声明窗口类：
立即学习“C++免费学习笔记（深入）”；
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
class MainWindow : public QMainWindow
{
Q_OBJECT // 必须添加，支持信号槽机制
public:
MainWindow(QWidget *parent = nullptr);
};
#endif // MAINWINDOW_H
在 mainwindow.cpp 中实现构造函数（可先不写内容，让窗口空白显示）：
linux-sysadmin
下载
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
#include "mainwindow.h"
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
{
resize(400, 300); // 设置初始大小
setWindowTitle("Hello Qt!"); // 设置窗口标题
}
3. 编写 main 函数并运行
在 main.cpp 中写启动逻辑：
#include <QApplication>
#include "mainwindow.h"
int main(int argc, char *argv[])
{
QApplication app(argc, argv); // 创建应用对象（必须）
MainWindow window; // 创建窗口实例
window.show(); // 显示窗口（关键！不调用就不会出现）
return app.exec(); // 启动事件循环（保持程序运行）
}
注意：show() 不能省略；exec() 是阻塞调用，负责处理鼠标、键盘等事件。
4. 构建与运行（以CMake为例）
在项目根目录写一个简版 CMakeLists.txt：
cmake_minimum_required(VERSION 3.16) project(helloqt) find_package(Qt6 REQUIRED COMPONENTS Widgets) set(CMAKE_CXX_STANDARD 17) add_executable(helloqt main.cpp mainwindow.cpp) target_link_libraries(helloqt Qt6::Widgets)
终端中依次执行：
mkdir build && cd build-
cmake ..（确保已配置好Qt6路径） cmake --build .-
./helloqt（Linux/macOS）或helloqt.exe（Windows）
看到标题为 “Hello Qt!” 的空白窗口，说明成功了。
