桌面应用 / 系统课时
规划应用目录和代码分层
规划应用目录和代码分层
本篇解决 Qt 桌面应用规模变大后窗口类不断膨胀的问题。通过合理规划目录和职责边界,将界面、业务逻辑、数据访问和通用能力拆开,让项目更容易维护、测试和继续扩展。
学习目标
- 理解 Qt 应用中常见代码职责划分方式
- 掌握按功能和层次组织项目目录的方法
- 能够避免把所有逻辑集中到主窗口类中
为什么需要代码分层
Qt 初学项目通常从一个主窗口开始,按钮响应、文件读写、数据处理都直接写在窗口类中。随着功能增加,窗口类会同时承担界面展示、业务判断和资源管理,最终难以修改。
代码分层的目标不是增加文件数量,而是让每个模块只负责一种变化。例如界面变化不应该迫使业务代码重写,数据来源变化也不应该影响按钮事件处理。
常见目录划分方式
一个中小型 Qt 6 桌面应用可以采用以下结构:
text
MyApplication/
├── CMakeLists.txt
├── main.cpp
├── src/
│ ├── ui/
│ │ ├── mainwindow.h
│ │ └── mainwindow.cpp
│ ├── service/
│ │ └── fileservice.h
│ │ └── fileservice.cpp
│ ├── model/
│ │ └── document.h
│ └── common/
│ └── appsettings.h
└── resources/
└── app.qrc其中各目录职责如下:
| 目录 | 职责 |
|---|---|
| ui | 窗口、控件、信号槽连接 |
| service | 业务流程和功能服务 |
| model | 业务数据对象 |
| common | 配置、工具类等公共能力 |
| resources | 图标、界面资源文件 |
这种结构适合功能持续增加的桌面程序。
在 Qt 中划分窗口和业务逻辑
主窗口应该负责接收用户操作,并调用业务对象完成任务,而不是直接实现所有处理细节。
例如文件打开功能,可以让窗口只负责触发:
cpp
// mainwindow.cpp 片段示例
// 依赖 MainWindow 已经拥有 FileService 成员对象
void MainWindow::onOpenClicked()
{
QString path = QFileDialog::getOpenFileName(this, "打开文件");
if (!path.isEmpty()) {
m_fileService.load(path);
}
}预期结果
text
用户点击打开按钮后:
1. 窗口弹出文件选择框
2. 用户选择文件
3. FileService 接收路径并执行加载逻辑窗口不需要知道文件解析细节,这样后续替换文件格式时只修改服务层。
使用 CMake 管理模块边界
Qt 6 项目通常使用 CMake 管理源文件。新增模块时,应明确加入对应源文件。
cmake
cmake_minimum_required(VERSION 3.16)
project(MyApplication)
find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_add_executable(MyApplication
main.cpp
src/ui/mainwindow.cpp
src/service/fileservice.cpp
)
target_link_libraries(MyApplication PRIVATE Qt6::Widgets)预期结果
text
CMake 配置成功后:
- ui 和 service 模块参与编译
- 应用可以正常链接 Qt Widgets分层设计中的常见边界
并不是所有类都需要独立成层。简单工具类可以保留在 common 中,小型窗口也可以直接包含少量逻辑。
需要拆分的信号通常包括:
- 单个窗口文件超过数百行
- 修改业务规则必须修改界面代码
- 多个页面重复实现相同功能
- 测试业务逻辑必须启动完整窗口
合理分层的最终目标是降低修改成本,而不是追求目录数量。
按自己的节奏,确认真正理解。