简介：本资源面向Qt5初学者与需要实现多窗口交互的开发者，聚焦多UI界面切换与弹窗显示这一常见需求。包内共29个文件，以cpp与h源码为主，配合3个ui设计文件、pro工程文件及Makefile等构建产物，压缩包约57KB，结构紧凑，便于直接编译运行与二次修改。内容围绕主窗口嵌入多个QWidget子窗口、通过show()与hide()完成切换，并借助QMessageBox与自定义QDialog实现模态弹窗，同时涉及信号与槽机制在窗口管理类中的通信应用。已有181人学习下载，适合作为课程设计、小型工具界面或Qt入门练习的参考模板，帮助读者快速理解多界面组织方式、弹窗调用流程与工程文件配置，减少从零搭建界面的时间成本。
1. 多界面切换与弹窗：一个 Qt5 桌面项目的骨架拆解
很多人第一次用 Qt5 写带界面的工具，都会卡在同一个地方：主窗口、设置页、关于页、登录框，到底该用QStackedWidget还是多开QWidget？弹窗是QDialog还是QMessageBox？我见过不少项目，界面一多就变成一堆show()和hide()互相打架，切回来控件状态全乱。这个项目就是冲着这个问题来的——它把 Qt5 里最常见的多 UI 界面切换和弹窗显示做成了一套可复用的骨架，适合刚接触 Qt 桌面开发、想找一个能直接跑起来改的起手项目的开发者。技术栈是 Qt5 + C++，构建走 qmake 或 CMake 都行，核心就围绕QStackedWidget、QDialog和信号槽三件事展开。
2. 项目结构与技术选型：为什么用 QStackedWidget 而不是多窗口
2.1 目录结构长什么样
拿到源码先别急着编译，花两分钟把目录扫一遍，后面改起来心里有底。这个项目的结构是典型的 Qt Widgets 应用布局，没有引入 Qt Quick，纯 C++ 加.ui文件：
project/ ├── main.cpp # 程序入口，创建 QApplication 和主窗口 ├── mainwindow.h/.cpp # 主窗口，持有 QStackedWidget 和所有页面 ├── mainwindow.ui # 主窗口布局，含 stackedWidget 和按钮区 ├── pages/ # 各个子页面 │ ├── homepage.h/.cpp/.ui │ ├── settingspage.h/.cpp/.ui │ └── aboutpage.h/.cpp/.ui ├── dialogs/ # 弹窗类 │ ├── logindialog.h/.cpp/.ui │ └── confirmdialog.h/.cpp/.ui └── project.pro # qmake 工程文件pages/下每个页面都是独立的QWidget子类，各自带.ui文件，互不干扰。dialogs/下是QDialog子类，负责模态或非模态弹窗。这种拆法的好处是：加一个新页面只需要新建一组文件，然后在主窗口里注册一下，不用动其他页面的代码。
2.2 为什么选 QStackedWidget 做页面容器
多界面切换在 Qt 里有两条路：一是开多个顶层窗口，用show()/hide()控制；二是用一个容器控件，把页面叠在一起，只显示当前页。这个项目选了后者，容器就是QStackedWidget。
原因很直接。多顶层窗口的方案，窗口管理交给操作系统，切换时焦点、层级、任务栏图标都会出问题，尤其在 Windows 上，隐藏的窗口还可能残留在任务栏。而QStackedWidget是 Qt 自己的控件，所有页面都在同一个窗口内，切换只是改一下当前索引，状态保留、焦点可控、布局统一。
主窗口的.ui里，核心就是一个QStackedWidget，加上底部或侧边的导航按钮。按钮点击后调用setCurrentIndex()或setCurrentWidget()，页面就切过去了。信号槽把按钮和切换动作连起来，不需要手写show()/hide()的逻辑。
2.3 弹窗的两种形态：QDialog 和 QMessageBox
弹窗部分，项目里分了两种。一种是自定义的QDialog子类，比如登录框、确认框，带自己的布局和控件；另一种是直接用QMessageBox做简单的提示、警告、询问。
QDialog用exec()就是模态，阻塞当前窗口直到关闭；用show()就是非模态，不阻塞。项目里登录框用exec()，因为登录没完成之前不应该操作主界面；而一些信息提示用QMessageBox::information()，一行代码搞定，不用单独建类。
注意：模态对话框用
exec()会开启一个局部事件循环，如果在里面再嵌套exec()，容易出现事件循环嵌套过深的问题，弹窗套弹窗要谨慎。
3. 核心模块拆解：页面切换、弹窗调用与信号槽连接
3.1 主窗口如何注册和切换页面
主窗口的职责很清晰：持有QStackedWidget，把各个页面加进去，然后提供切换接口。先看头文件里怎么声明：
// mainwindow.h #ifndef MAINWINDOW_H #define MAINWINDOW_H #include <QMainWindow> #include "pages/homepage.h" #include "pages/settingspage.h" #include "pages/aboutpage.h" QT_BEGIN_NAMESPACE namespace Ui { class MainWindow; } QT_END_NAMESPACE class MainWindow : public QMainWindow { Q_OBJECT public: MainWindow(QWidget *parent = nullptr); ~MainWindow(); private slots: void onHomeBtnClicked(); // 导航按钮槽函数 void onSettingsBtnClicked(); void onAboutBtnClicked(); private: Ui::MainWindow *ui; HomePage *homePage; // 页面对象指针 SettingsPage *settingsPage; AboutPage *aboutPage; void initPages(); // 初始化页面并加入 stackedWidget void connectNavButtons(); // 连接导航按钮信号槽 }; #endif // MAINWINDOW_H这里每个页面都是一个独立对象，用指针持有。initPages()负责创建实例并addWidget()到ui->stackedWidget，connectNavButtons()把按钮的clicked信号连到对应的槽。
再看实现：
// mainwindow.cpp #include "mainwindow.h" #include "ui_mainwindow.h" MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , ui(new Ui::MainWindow) { ui->setupUi(this); initPages(); // 先把页面加进去 connectNavButtons(); // 再连信号槽 ui->stackedWidget->setCurrentIndex(0); // 默认显示首页 } void MainWindow::initPages() { homePage = new HomePage(this); settingsPage = new SettingsPage(this); aboutPage = new AboutPage(this); ui->stackedWidget->addWidget(homePage); // 索引 0 ui->stackedWidget->addWidget(settingsPage); // 索引 1 ui->stackedWidget->addWidget(aboutPage); // 索引 2 } void MainWindow::connectNavButtons() { connect(ui->homeBtn, &QPushButton::clicked, this, &MainWindow::onHomeBtnClicked); connect(ui->settingsBtn, &QPushButton::clicked, this, &MainWindow::onSettingsBtnClicked); connect(ui->aboutBtn, &QPushButton::clicked, this, &MainWindow::onAboutBtnClicked); } void MainWindow::onHomeBtnClicked() { ui->stackedWidget->setCurrentIndex(0); } void MainWindow::onSettingsBtnClicked() { ui->stackedWidget->setCurrentIndex(1); } void MainWindow::onAboutBtnClicked() { ui->stackedWidget->setCurrentIndex(2); }逻辑说明：addWidget()的顺序决定了索引值，第一个加进去的是 0，第二个是 1，以此类推。切换时用setCurrentIndex()比setCurrentWidget()更直接，因为索引是固定的。参数方面，setCurrentIndex(int)传入越界值不会崩溃，但会静默失败，所以索引最好用枚举或常量管理，别写魔法数字。
提示：如果页面数量会动态变化，建议用
setCurrentWidget(pointer)，避免索引错位。
3.2 自定义弹窗：登录框的模态调用
登录框是一个QDialog子类，带用户名、密码输入框和确认/取消按钮。它的调用方式决定了它是模态还是非模态：
// 在主窗口某个槽函数中调用登录框 void MainWindow::onLoginActionTriggered() { LoginDialog dlg(this); // 栈上创建，父对象是主窗口 dlg.setWindowTitle("登录"); if (dlg.exec() == QDialog::Accepted) { QString user = dlg.getUsername(); // 获取输入的用户名 // 登录成功后的处理 ui->statusBar->showMessage("欢迎: " + user, 3000); } else { // 用户取消，什么都不做 } }逻辑说明：exec()是阻塞调用，会开启模态事件循环，直到对话框关闭才返回。返回值是QDialog::Accepted或QDialog::Rejected，对应确认和取消。getUsername()是自定义的 getter，在对话框内部从QLineEdit读取文本。
参数说明：LoginDialog dlg(this)里的this是父窗口指针，作用是让对话框居中显示在父窗口上，并且父窗口销毁时自动清理。如果不想阻塞，把exec()换成show()，但那样就得自己处理返回结果，通常用信号槽。
3.3 信号槽连接：页面间通信的正确姿势
页面之间不应该直接互相引用，否则耦合太紧。这个项目里，页面需要通知主窗口做切换时，用信号：
// settingspage.h 中声明信号 signals: void requestHomePage(); // 请求切换到首页 // settingspage.cpp 中某个按钮点击时发射 void SettingsPage::onBackBtnClicked() { emit requestHomePage(); } // mainwindow.cpp 中连接 connect(settingsPage, &SettingsPage::requestHomePage, this, &MainWindow::onHomeBtnClicked);逻辑说明：子页面只负责发射信号，不关心谁接收、怎么处理。主窗口作为协调者，把信号连到自己的槽上。这样加一个新页面或者改切换逻辑，只需要动主窗口的连接代码，页面本身不用改。
参数说明：connect的第五个参数默认是Qt::AutoConnection，同一线程内就是直连，跨线程会自动变成队列连接。这个项目全是单线程 UI，不用管。
4. 编译运行与避坑：从 qmake 到第一次启动
4.1 用 qmake 编译的完整步骤
项目根目录下有.pro文件，用 qmake 构建最省事。假设已经装好 Qt5 和对应编译器：
# 在项目根目录下 qmake project.pro # 生成 Makefile make # Linux/macOS 下编译 # 或者 Windows + MinGW mingw32-make编译完成后，可执行文件在release/或debug/目录下，直接运行即可。如果用 Qt Creator，打开.pro文件，选好 Kit，点运行按钮就行。
注意：
.pro文件里要确保QT += widgets，否则QApplication、QWidget这些头文件找不到。
4.2 避坑记录：五个容易翻车的地方
现象一：编译报错 “undefined reference to vtable for XxxPage”原因：带Q_OBJECT宏的类，moc 没有处理到。常见于手动写了.h但忘了把.h加进.pro的HEADERS，或者改了类名没重新跑 qmake。 解决：检查.pro里HEADERS和SOURCES是否包含所有文件，然后重新执行qmake再make。Qt Creator 里可以右键项目选“执行 qmake”。
现象二：切换页面后，原来页面上的输入内容丢了原因：页面对象被意外销毁重建了。如果每次切换都new一个新页面，旧的自然没了。 解决：页面对象在initPages()里只创建一次，切换只用setCurrentIndex()，不要重复addWidget()同一个页面，否则会重复添加。
现象三：弹窗关闭后程序崩溃原因：对话框对象在栈上创建，exec()返回后对象析构，但如果有信号槽还连着它，或者有指针被保存下来，就会访问已释放内存。 解决：栈上创建的对话框，不要保存它的指针到成员变量。如果需要复用，用new创建并设置Qt::WA_DeleteOnClose属性，或者手动deleteLater()。
现象四：模态对话框不阻塞，主窗口还能点原因：用了show()而不是exec()，或者对话框的modal属性没设。 解决：需要阻塞就用exec()；如果坚持用show()，调用setModal(true)再show()。
现象五：中文显示乱码原因：源文件编码和 Qt 运行时编码不一致。Qt5 默认按 UTF-8 处理，但 Windows 上 MSVC 可能按本地代码页。 解决：源文件统一保存为 UTF-8，在main.cpp里加QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"))，或者用QStringLiteral包裹中文字符串。
5. 二次开发改造：加页面、换弹窗、抽接口
5.1 加一个新页面的标准流程
假设要加一个“数据统计”页面，步骤是固定的：新建statisticspage.h/.cpp/.ui，继承QWidget，在.ui里画好布局；然后在mainwindow.h里加成员指针，在initPages()里new并addWidget()，在导航区加一个按钮，在connectNavButtons()里连上槽，槽里setCurrentIndex()到新索引。整个过程不需要动其他页面的代码，这就是拆分的价值。
5.2 把弹窗调用抽成统一接口
项目里弹窗调用散落在各个槽函数里，二次开发时如果弹窗样式要统一改，会很难受。我一般会抽一个DialogHelper单例或命名空间，把常用弹窗封装成静态函数：
// dialoghelper.h namespace DialogHelper { bool confirm(QWidget *parent, const QString &title, const QString &text); void info(QWidget *parent, const QString &text); QString getText(QWidget *parent, const QString &title, const QString &label); }实现里用QMessageBox或自定义QDialog，调用方只关心结果，不关心具体是哪种弹窗。这样以后换 UI 风格，只改一个文件。
5.3 用枚举管理页面索引
前面提到索引不要写魔法数字。改造时加一个枚举：
enum PageIndex { Page_Home = 0, Page_Settings, Page_About, Page_Statistics, Page_Count // 用于校验 };切换时用setCurrentIndex(Page_Settings)，加页面时在枚举里插一个，索引自动调整。配合Q_ASSERT(index < Page_Count)做边界检查，比裸数字靠谱得多。
5.4 验证改造是否成功的检查清单
改完之后别急着提交，按这几条过一遍：新页面能否正常显示，切换回来状态是否保留；弹窗关闭后主窗口是否正常响应；所有按钮点击是否有对应反应；编译是否有警告；内存有没有明显泄漏（用 Valgrind 或 Qt Creator 的分析器跑一下）。我自己的习惯是，每次加完页面，先把所有导航按钮点一遍，再打开每个弹窗关掉，最后看一遍控制台输出有没有QObject::connect的警告。从那以后我每次改完 UI 都强制走一遍这个流程，省得后面调试花更多时间。希望帮到你。
本文还有配套的精品资源，点击获取
