桌面应用 / 系统课时

规划应用目录和代码分层

规划应用目录和代码分层

本篇解决 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 中,小型窗口也可以直接包含少量逻辑。

需要拆分的信号通常包括:

  • 单个窗口文件超过数百行
  • 修改业务规则必须修改界面代码
  • 多个页面重复实现相同功能
  • 测试业务逻辑必须启动完整窗口

合理分层的最终目标是降低修改成本,而不是追求目录数量。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

规划应用目录和代码分层

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通