在 Qt 开发中，界面开发的基础是窗口基类的选择。QMainWindow、QWidget、QDialog 是最常用的三个窗口类，它们定位不同、适用场景各异。很多新手在创建项目时会纠结该选哪个，本文将从核心区别、使用场景、继承关系等方面，帮你彻底理清三者的差异。

一、核心区别对比表

表格

特性	QMainWindow	QWidget	QDialog
核心定位	应用程序主窗口	Qt 所有 UI 控件的基类（通用容器）	交互式对话框 / 弹窗
自带 UI 元素	菜单栏、工具栏、状态栏、停靠区域、中心部件	无任何默认 UI 元素（空白画布）	标准按钮（OK/Cancel/Apply）、标题栏
使用场景	完整应用的主界面（如 IDE、办公软件）	自定义控件、子界面、极简窗口	弹窗、提示框、设置窗口、向导页
默认窗口行为	非模态，可独立运行	非模态，可作为子窗口 / 控件容器	支持模态（阻塞父窗口）/ 非模态
能否做主窗口	✅ 最推荐	✅ 极简场景（无菜单栏需求）	❌ 不适合（仅作临时交互）

二、逐个详解

1. QMainWindow：应用的 “主舞台”

QMainWindow 是为完整应用主界面量身设计的窗口类，自带一套成熟的 UI 框架，无需手动搭建基础结构。

• 核心结构：
  • 菜单栏（QMenuBar）：放置文件、编辑、视图等菜单
  • 工具栏（QToolBar）：快捷操作按钮
  • 状态栏（QStatusBar）：显示状态信息、进度等
  • 停靠区域（QDockWidget）：可自由拖拽的子窗口
  • 中心部件（QWidget）：所有核心内容的承载容器（必须设置）
• 适用场景：需要菜单栏、工具栏、状态栏的应用，比如 Qt Creator、视频播放器、办公软件等。就像一个自带灯光、幕布、后台的完整舞台，直接就能上演 “完整大戏”。
• 使用注意：必须通过 setCentralWidget() 设置中心部件，否则界面内容无法正常显示；同时可通过 addToolBar()、menuBar() 等方法添加基础 UI 元素。

2. QWidget：Qt 的 “万物之基”

QWidget 是 Qt 所有 UI 控件的根基类（QMainWindow、QDialog、QPushButton、QLabel 等都继承自它），本身没有任何预设的 UI 样式，是一块 “空白画布”。

• 核心特点：灵活性极高，可作为任意控件的容器，也可直接作为顶级窗口使用。
• 适用场景：
  1. 自定义控件：比如制作复杂的组合控件（如带图标的输入框）
  2. 极简窗口：无需菜单栏、工具栏的简单界面
  3. 子界面 / 布局容器：作为其他窗口的子部件，承载多个控件
  4. 嵌入式 UI：在其他框架中嵌入 Qt 界面就像一块任意裁剪的木板，你可以把它搭成桌子、椅子、舞台，全看自己的设计。
• 使用注意：作为顶级窗口时，默认没有关闭按钮、图标，也无菜单栏；若需标题栏，需手动设置窗口属性，且无法直接使用QMainWindow的菜单 / 工具栏体系。

3. QDialog：交互的 “弹窗助手”

QDialog 是专门为临时交互式窗口设计的类，核心用于弹窗交互，是 Qt 中弹窗的首选基类。

• 核心特点：自带标准按钮（OK/Cancel/Apply），支持两种核心模式：
  • 模态弹窗：阻塞父窗口，用户必须先处理弹窗（如点击 OK）才能操作主窗口
  • 非模态弹窗：不阻塞父窗口，可同时操作主窗口和弹窗
• 适用场景：
  1. 临时交互：提示框、确认框（如 “是否保存文件？”）
  2. 配置窗口：软件设置、参数配置弹窗
  3. 向导式界面：分步操作的向导窗口就像一个临时的小展台，用户看完、做完选择后就会关闭，不会长期占用主界面。
• 使用注意：默认无最大化 / 最小化按钮，不适合作为长期主窗口；弹窗需通过 exec()（模态）或 show()（非模态）显示。

三、继承关系

三者的继承关系清晰体现了 “通用到特殊” 的设计逻辑：

plaintext

QObject
  ↑
QWidget  ← 所有Qt控件/窗口的基类
  ↑      ↑
QDialog QMainWindow

• QWidget 是基础，提供了窗口的核心属性（大小、位置、样式、事件处理等）
• QDialog 基于QWidget，增加了弹窗交互的专属逻辑
• QMainWindow 基于QWidget，增加了主窗口的基础框架

四、快速选择指南

创建窗口时，按以下规则直接选择，无需纠结：

1. 做应用主界面，需要菜单栏 / 工具栏 / 状态栏 → 选 QMainWindow
2. 做自定义控件、极简窗口、子界面 → 选 QWidget
3. 做弹窗、提示框、配置窗口 → 选 QDialog

五、示例代码

1. QMainWindow 示例

cpp

运行

#include <QMainWindow>
#include <QLabel>
#include <QMenuBar>
#include <QStatusBar>

class MainWindow : public QMainWindow {
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
        // 设置中心部件
        QWidget *centralWidget = new QWidget(this);
        this->setCentralWidget(centralWidget);

        // 添加菜单栏
        QMenu *fileMenu = this->menuBar()->addMenu("文件");
        fileMenu->addAction("打开");

        // 添加状态栏
        this->statusBar()->showMessage("就绪");

        // 中心部件添加标签
        QLabel *label = new QLabel("主窗口内容", centralWidget);
        label->setAlignment(Qt::AlignCenter);
    }
};

2. QWidget 示例

cpp

运行

#include <QWidget>
#include <QLabel>
#include <QVBoxLayout>

class SimpleWidget : public QWidget {
    Q_OBJECT
public:
    SimpleWidget(QWidget *parent = nullptr) : QWidget(parent) {
        // 垂直布局
        QVBoxLayout *layout = new QVBoxLayout(this);
        // 添加控件
        layout->addWidget(new QLabel("自定义QWidget界面"));
        layout->addWidget(new QPushButton("按钮"));
        this->setLayout(layout);
    }
};

3. QDialog 示例

cpp

运行

#include <QDialog>
#include <QPushButton>
#include <QVBoxLayout>
#include <QMessageBox>

class ConfigDialog : public QDialog {
    Q_OBJECT
public:
    ConfigDialog(QWidget *parent = nullptr) : QDialog(parent) {
        this->setWindowTitle("配置窗口");
        // 布局
        QVBoxLayout *layout = new QVBoxLayout(this);
        QPushButton *okBtn = new QPushButton("确定", this);
        layout->addWidget(okBtn);
        this->setLayout(layout);

        // 按钮点击事件
        connect(okBtn, &QPushButton::clicked, this, [=]() {
            QMessageBox::information(this, "提示", "配置已保存");
            this->accept(); // 关闭模态弹窗
        });
    }
};

总结

• QMainWindow 是主窗口专属，自带完整框架，适合完整应用
• QWidget 是万能容器，灵活度最高，适合自定义 / 极简场景
• QDialog 是弹窗专用，支持模态交互，适合临时交互界面