第26章 QT项目实战（一）

课程目录第26章 QT项目实战（一）

第26章 QT项目实战（一）：需求分析、界面原型设计、项目结构搭建、信号与槽规划

终于到了实战环节。说实话，前面那么多基础内容，大家可能已经有点手痒了。这一章我们不做小demo，直接上手一个完整的项目。我会带着你从零开始，走一遍真正的开发流程。

你可能会问：为什么非要搞需求分析、画原型这些“虚”的东西？直接写代码不香吗？

嗯，我刚开始学QT那会儿也是这么想的。结果呢？写了两天发现功能漏了，界面布局要重来，信号槽连得乱七八糟……后来我学乖了——磨刀不误砍柴工。花半小时做规划，能省下两天改代码的时间。

26.1 项目需求分析

我们这次要做的项目叫“智能设备监控面板”。说白了，就是一个能实时显示设备状态、接收报警、记录日志的小工具。

先别急着想代码。咱们得搞清楚：这个软件到底要干什么？

26.1.1 核心功能清单

我习惯用列表把需求一条条列出来，这样后面做设计才不会漏。

设备状态显示：实时展示每台设备的运行状态（在线/离线/故障）
数据监控：显示关键参数，比如温度、电压、转速
报警管理：当参数超出阈值时，弹出报警提示
日志记录：记录所有操作和报警事件，支持按时间查询
用户管理：简单的登录功能，区分管理员和普通用户

这里有个坑：需求一定要写清楚“边界”。比如“实时显示”到底多实时？1秒刷新一次还是100毫秒？我曾经有个项目，客户说“实时”，结果要求10毫秒刷新……那根本就不是QT能搞定的，得上专门的工控机。

26.1.2 用户角色分析

这个系统就两种用户：

角色	权限	典型操作
普通用户	查看数据、确认报警	浏览设备状态、点击“确认报警”按钮
管理员	全部权限	添加/删除设备、修改阈值、查看日志

为什么要区分角色？因为后面做界面设计时，不同角色看到的菜单和按钮是不一样的。这个在原型设计阶段就要想清楚。

26.2 界面原型设计

好，需求清楚了。接下来画原型。

我一般用纸笔或者简单的绘图工具画草图。别纠结工具，关键是把界面布局想明白。

26.2.1 主界面布局

我们的主界面分三块：

左侧导航栏：设备列表、报警列表、日志查询、系统设置
中间内容区：根据左侧选择显示不同内容
底部状态栏：显示当前用户、系统时间、连接状态

这个布局很经典，QT里用QSplitter或者QHBoxLayout + QStackedWidget就能实现。

26.2.2 设备监控页面原型

设备监控页面是核心。我设计成卡片式布局：

每个设备一张卡片
卡片上显示设备名称、状态指示灯（绿/红/黄）、关键参数
点击卡片进入详情页

你想想看，如果设备多了，用表格显示会密密麻麻的。卡片式更直观，一眼就能看出哪些设备出问题了。

我的经验：原型设计时，多想想“异常情况”。比如设备离线了，卡片应该怎么显示？报警时要不要闪烁？这些细节在原型阶段想好，后面写代码就顺畅了。

26.3 项目结构搭建

原型画完了，该动手了。但别急着写界面代码，先把项目结构搭好。

我见过太多人把所有代码塞到一个文件里，结果项目到后期根本没法维护。咱们从一开始就养成好习惯。

26.3.1 目录结构

我的习惯是这样：

DeviceMonitor/
├── src/
│   ├── main.cpp
│   ├── mainwindow.h / .cpp
│   ├── views/          // 界面相关
│   │   ├── deviceview.h / .cpp
│   │   ├── alarmview.h / .cpp
│   │   └── logview.h / .cpp
│   ├── models/         // 数据模型
│   │   ├── devicemodel.h / .cpp
│   │   └── alarmmodel.h / .cpp
│   ├── controllers/    // 业务逻辑
│   │   ├── devicecontroller.h / .cpp
│   │   └── alarmcontroller.h / .cpp
│   └── utils/          // 工具类
│       ├── database.h / .cpp
│       └── logger.h / .cpp
├── resources/
│   ├── icons/
│   └── styles/
├── tests/
└── CMakeLists.txt

这个结构是典型的MVC模式。View只管显示，Model只管数据，Controller管业务逻辑。各司其职，互不干扰。

注意：别把数据库操作写在界面类里。我曾经接手过一个项目，QPushButton的点击事件里直接写了SQL查询……那代码简直没法看。

26.3.2 CMake配置

我们用CMake来构建项目。这里给出核心配置：

cmake_minimum_required(VERSION 3.16)
project(DeviceMonitor VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets Sql)

add_executable(DeviceMonitor
    src/main.cpp
    src/mainwindow.cpp
    src/views/deviceview.cpp
    src/views/alarmview.cpp
    src/views/logview.cpp
    src/models/devicemodel.cpp
    src/models/alarmmodel.cpp
    src/controllers/devicecontroller.cpp
    src/controllers/alarmcontroller.cpp
    src/utils/database.cpp
    src/utils/logger.cpp
)

target_link_libraries(DeviceMonitor PRIVATE Qt6::Widgets Qt6::Sql)

注意我开了AUTOMOC，这样QT的元对象编译器会自动处理信号槽。省事。

26.4 信号与槽规划

项目结构搭好了，接下来是最关键的一步——规划信号与槽。

信号与槽是QT的灵魂。规划得好，代码像流水一样顺畅；规划得不好，那就是一团乱麻。

26.4.1 核心信号链路

我画了一张图，展示我们项目里主要的信号传递路径：

这张图里，信号流向很清晰：

数据采集模块发出dataReceived()信号
控制器收到后处理数据，判断是否报警
控制器发出updateDisplay()信号，界面刷新
用户操作界面时，发出userAction()信号
控制器处理用户操作，必要时调用数据库

26.4.2 具体信号槽定义

下面是我们项目中几个关键的信号槽声明：

// devicecontroller.h
class DeviceController : public QObject {
    Q_OBJECT
public:
    explicit DeviceController(QObject *parent = nullptr);

signals:
    void deviceStatusChanged(int deviceId, DeviceStatus status);
    void alarmTriggered(int deviceId, QString message);
    void dataUpdated(int deviceId, QVariantMap data);

public slots:
    void onDataReceived(int deviceId, QVariantMap rawData);
    void onUserAcknowledgeAlarm(int alarmId);
    void onThresholdChanged(int deviceId, QString param, double value);
};

// deviceview.h
class DeviceView : public QWidget {
    Q_OBJECT
public:
    explicit DeviceView(QWidget *parent = nullptr);

signals:
    void deviceClicked(int deviceId);
    void alarmAcknowledged(int alarmId);

public slots:
    void onDeviceStatusChanged(int deviceId, DeviceStatus status);
    void onAlarmTriggered(int deviceId, QString message);
    void onDataUpdated(int deviceId, QVariantMap data);
};

一个小技巧：信号参数尽量用基础类型或者QVariant。别传自定义类的指针，否则跨线程时会出问题。我吃过这个亏，调试了两天才发现是信号参数类型不匹配。

26.4.3 连接策略

信号槽的连接方式，我建议这样：

同线程连接：用默认的Qt::AutoConnection，QT会自动选择直连还是队列
跨线程连接：显式指定Qt::QueuedConnection，确保线程安全
一次性连接：用Qt::SingleShotConnection（QT6新增），触发一次后自动断开

举个例子，数据采集模块如果在子线程，连接时要小心：

// 主线程中连接
connect(dataCollector, &DataCollector::dataReceived,
        deviceController, &DeviceController::onDataReceived,
        Qt::QueuedConnection);  // 跨线程，必须用队列连接

26.5 本章小结

这一章我们做了三件事：

需求分析：明确了项目要做什么，用户是谁
原型设计：画出了界面布局，想好了交互方式
项目搭建：建立了目录结构，规划了信号槽

你可能觉得这些工作“不写代码”，没什么成就感。但说实话，一个项目能不能顺利推进，80%取决于前期规划。我见过太多项目，代码写了一半发现需求不对，推倒重来……那才叫真的痛苦。

下一章，我们会正式开始写代码。到时候你会发现，因为现在规划得清楚，写起来特别顺畅。嗯，这就是“磨刀”的价值。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录