桌面应用 / 系统课时
看懂 Qt 工程目录与文件
看懂 Qt 工程目录与文件
本篇帮助你理解一个 Qt 6 项目中常见文件的职责,知道 CMake 配置、入口代码和窗口类如何协作,从而能够快速定位代码位置并修改桌面应用。
学习目标
- 了解 Qt 工程中主要文件的职责和组织方式。
- 理解 main.cpp、窗口类头文件与源文件之间的关系。
- 能够根据项目结构判断新增功能应该放在哪个文件中。
Qt 项目的基本组成
一个 Qt 6 桌面项目通常由构建文件、程序入口、界面类以及资源文件组成。文件数量可能随着项目规模增加,但职责划分通常保持稳定。
常见结构如下:
| 文件 | 作用 |
|---|---|
| CMakeLists.txt | 描述项目构建规则、依赖和目标程序 |
| main.cpp | 程序启动入口,创建应用对象并显示窗口 |
| 窗口类头文件(如 mainwindow.h) | 声明窗口类、成员变量和函数 |
| 窗口类源文件(如 mainwindow.cpp) | 实现窗口行为和业务逻辑 |
| .ui 文件 | 使用 Qt Designer 保存界面布局 |
| 资源文件(如 .qrc) | 管理图片、图标等静态资源 |
理解这些职责后,修改 Qt 应用时就不会把所有代码都堆积到入口文件中。
程序入口 main.cpp 的职责
Qt 应用启动时需要创建 QApplication 对象,并创建顶层窗口。main.cpp 通常只负责启动流程,不应该包含复杂业务逻辑。
cpp
#include <QApplication>
#include "mainwindow.h"
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
MainWindow window;
window.show();
return app.exec();
}这段代码完成三个动作:初始化 Qt 运行环境、创建窗口对象、进入事件循环。按钮点击、窗口刷新等行为会在事件循环中持续处理。
预期输出
text
启动 Qt 应用后显示一个主窗口,关闭窗口后程序退出。窗口类的头文件与源文件
Qt 中常用类拆分方式是将接口声明和实现分离。例如窗口类通常包含两个文件:
mainwindow.h 声明窗口有哪些能力:
cpp
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
class MainWindow : public QMainWindow
{
public:
explicit MainWindow(QWidget *parent = nullptr);
};
#endifmainwindow.cpp 负责具体实现:
cpp
#include "mainwindow.h"
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
{
setWindowTitle("Qt 6 Demo");
}预期结果
text
运行程序后,窗口标题显示为 Qt 6 Demo。这种拆分方式让界面声明、事件处理和业务代码更加容易维护。
如何判断代码应该放在哪里
开发 Qt 应用时,可以根据职责选择文件:
- 修改窗口初始化逻辑,通常放在窗口类构造函数中。
- 增加按钮点击处理,通常放在窗口类源文件中。
- 修改依赖模块或编译选项,修改 CMakeLists.txt。
- 控制程序启动流程,修改 main.cpp。
不要把业务逻辑全部写进 main.cpp,否则项目增长后会难以维护。
常见项目维护误区
初学者经常把所有代码写在入口文件中,导致窗口创建、数据处理和界面控制混杂。Qt 的类设计鼓励按照对象职责拆分代码,让每个文件只负责一类问题。
当项目从单窗口扩展到多个页面时,清晰的目录结构会明显降低后续修改成本。
按自己的节奏,确认真正理解。