尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Aether 项目 3 年重构 4 次,我学到的 5 个教训
从能跑就行到架构清晰工业项目的进化之路一、一个真实的病历本第一版 Aether一个巨大的 main.cpp所有代码堆在一起。第二版 Aether分出了 common/app/plugins但耦合依然严重。第三版 Aether引入了 IoC 容器插件间终于解耦了。第四版 Aether完整的 MVVM 中间件 权限 主题。每次重构都像在动手术。但每次手术后项目都活得更好了。这不是教你如何写出完美架构的文章。这是把 3 年挨过的刀、踩过的坑、流过的血一条条摆在你面前。二、V1 → V2从单体到分层改一个 bug 修 3 天V1 的 Aether核心逻辑全在一个main.cpp里2 万多行。// V1 main.cpp节选#includeQApplication#includeQTcpSocket#includeQSerialPort#includeQCamera#includeQSqlDatabase// 全局变量大集合QCamera*g_cameranullptr;QTcpSocket*g_commnullptr;QSqlDatabase g_db;intg_currentMode0;// 2 万行代码全部平铺// 相机初始化、通信协议解析、界面更新、// 数据库写入、异常处理...全混在一起问题在哪改一行g_comm的协议解析相机也跟着崩。因为全局变量谁都改谁都不清楚改完的影响范围。有一次修界面卡死的 bug定位到g_comm-readAll()阻塞了 UI 线程。但通信、界面、数据库都在同一个函数里互相调用。改 1 个 bug用了 3 天。因为不敢动动一处要验证所有地方没炸。分层后效率翻倍V2 我们做了第一件正确的事按职责分层。V1 V2 aether/ aether/ └── main.cpp ← 2万行 ├── app/main.cpp ├── common/ │ ├── comm/ ← 通信模块 │ ├── camera/ ← 相机模块 │ └── database/ ← 数据库模块 └── plugins/ui/ ← 界面模块每个模块有自己的文件夹、命名空间、编译单元。模块之间通过接口调用不碰对方的全局变量。// V2 common/comm/comm_manager.h// 通信模块对外只暴露这一个接口classCommManager:publicQObject{Q_OBJECTpublic:boolsend(constQByteArraydata);voidonReceived(std::functionvoid(constQByteArray)cb);};以前改通信要在 2 万行里找所有相关代码。现在改通信只打开common/comm/就行。效果原来 3 个人改同一个文件天天冲突。分层后并行开发6 周的工作 2 周交付。三、V2 → V3从分层到插件化分层也没解决耦合分层之后新问题冒头了——模块间依赖还是太强。改了camera_manager.cpp的参数类型comm/和ui/各有三处调用了它全要跟着改。// V2 的问题模块间直接调用耦合太深voidCommManager::onDataReceived(constQByteArraydata){automsgparse(data);// 直接调用 database 模块的接口DatabaseManager::instance().saveRecord(msg);// 直接调用 ui 模块的接口UIManager::instance().updateDisplay(msg);}分层的思路对了但层与层之间还是硬编码耦合。插件化痛在接口设计V3 引入插件架构每个模块编译成独立 DLL通过接口交互。// V3 通信插件接口// plugins/interface/icommunication.hclassICommunication:publicQObject{Q_OBJECTpublic:virtual~ICommunication()default;virtualboolconnect(constQStringendpoint)0;virtualboolsend(constQByteArraydata)0;virtualboolisConnected()const0;signals:virtualvoiddataReceived(constQByteArraydata)0;};最大的痛苦是接口设计。第一版ICommunication有 12 个方法。结果每个插件TCP、串口、CAN只实现了其中 6 个剩下 6 个写return false。接口太胖插件架构就废了。后来拆成 3 个小接口各取所需。四、V3 → V4从插件到 IoC MVVM插件间还是太依赖插件化解决了改一处崩全局。但新问题来了——插件 A 依赖插件 B 的实例加载顺序成了玄学。// V3 的痛加载顺序玄学auto*bpluginManager-getPluginIPluginB();if(!b)return;// 插件 B 还没加载b-doSomething();今天能跑明天加个新插件加载顺序变了又崩。IoC 容器真正解耦V4 的核心变化引入 IoC 容器你需要的服务容器给你注入不用自己找。// V4 - 容器自动注入依赖classServiceA:publicQObject{public:explicitServiceA(IServiceB*serviceB):m_serviceB(serviceB)// ← 容器自动注入{// 直接使用不用关心 serviceB 什么时候初始化的connect(m_serviceB,IServiceB::onEvent,this,ServiceA::handleEvent);}private:IServiceB*m_serviceBnullptr;};容器带来三个改变不用关心加载顺序容器按依赖图排序、不用硬编码实现换实现只改注册、测试友好注册 Mock 即可。MVVM 同时解决了 UI 和业务层的耦合// V4 - ViewModel 层classMainViewModel:publicQObject{Q_PROPERTY(QString status READ status NOTIFY statusChanged)public:explicitMainViewModel(ICameraService*camera,ICommService*comm):m_camera(camera),m_comm(comm){}Q_INVOKABLEvoidstartCapture(){m_camera-start();m_status采集中...;emitstatusChanged();}private:ICameraService*m_camera;ICommService*m_comm;QString m_status;};View 只绑 ViewModel 的属性ViewModel 通过容器拿服务。每个维度都解耦了。五、5 个用血泪换来的教训教训 1不要过早抽象V1 到 V2我们最大的冲动是先把框架搭好。搭了一个极其通用的数据总线架构设计了 8 个抽象层。结果业务写了两行发现用不上绕开框架直接走硬编码。抽象不是设计出来的是从代码里长出来的。先写能跑的代码再抽公共逻辑。V2 到 V3 我们换了这个策略——先在业务里发现重复模式再抽接口。这次对了。教训 2接口变动要发版V3 的插件接口改得很随意。今天加个方法明天改返回值。插件开发者天天追着接口改一个接口改了 5 次6 个插件崩了 4 次。后来强推语义化版本icommunication v1.0.0 ← 稳定版不能改 icommunication v1.1.0 ← 加新方法不破已有签名 icommunication v2.0.0 ← 破坏性变更全员确认接口变动必须发版、写变更日志、通知所有消费者。这规矩定了之后插件间的地震几乎绝迹。教训 3架构文档和代码同步V2 到 V3 踩过最大的坑——代码重构了文档没更新。新同事拿着 V2 的文档理解 V3 的代码前两个月全在考古中度过。我们的解法架构图放进代码仓库、和代码一起 PR、每次重构先改文档再改代码。教训 4重构时测试先行V2 到 V3 那次重构我们没写测试就直接上。结果是——每个接口都能工作但流程跑起来到处断链。不写测试的重构不叫重构叫赌博。后来定了死规矩重构前先给现有代码写测试锁定接口行为。重构完跑一遍全绿才算通过。// 重构前锁定行为TEST_CASE(通信模块发送数据){CommManager comm;REQUIRE(comm.send(QByteArray())false);// 空数据返回 falseREQUIRE(comm.send(QByteArray(hello))true);// 合法数据返回 trueboolsignalReceivedfalse;QObject::connect(comm,CommManager::dataSent,[](){signalReceivedtrue;});comm.send(QByteArray(hello));REQUIRE(signalReceivedtrue);}教训 5渐进式重构 推倒重来4 次重构里最失败的是 V2 中期的大重写。花了 3 个月写了 80% 的新代码然后发现——业务已经变了。3 个月白干。推倒重来永远是最后的选择。正确的做法是用 Strangler Fig 模式在旧系统旁建新模块新功能走新模块逐步迁移老功能老功能没人用了再拆掉V3 到 V4 这么干的——IoC 容器和旧架构共存了 2 个月等所有插件迁移完才删旧代码。没有切换日只有淘汰日。六、现在的 Aether┌────────────────────────────────────┐ │ View 层 (QML/QWidget) │ │ 只做展示不写业务 │ ├────────────────────────────────────┤ │ ViewModel 层 │ │ 属性绑定 命令调度 │ ├────────────────────────────────────┤ │ Service 层 (IoC 容器管理) │ │ 相机 · 通信 · 数据服务 │ ├────────────────────────────────────┤ │ 插件层 (独立 DLL接口交互) │ │ core · mvvm · container · home │ └────────────────────────────────────┘每一层只关心一件事每一层都可以独立替换。3 年4 次重构从一个 2 万行的 main.cpp 到今天。如果你问我最大的感受是什么没有一劳永逸的架构只有不断进化的代码。下一次重构什么时候来我不知道。但只要项目还活着重构就不会停。 评论区聊聊你的项目重构过几次最大的教训是什么是接口设计翻车了还是测试没跟上评论区说说你的经历。 觉得有用分享给你的团队——这些教训一个人用血泪换来十个人看到就能少走弯路。⭐ 点个在看让更多人看到也鼓励我继续写下去。下一期预告下一篇从 Windows 到 Linux——跨平台适配。你以为 Qt 是跨平台的光是文件路径的斜杠方向就够你喝一壶的。下篇聊聊 Aether 跨平台适配的真实经历。
RELATED

相关推荐

企业级合规审计架构:Spring Boot 全链路操作日志与动态数据脱敏实战

企业级合规审计架构:Spring Boot 全链路操作日志与动态数据脱敏实战

做审计日志和敏感数据脱敏,很多团队的第一反应就是加个拦截器打日志,再写个工具类把手机号中间四位换成 ****。结果一上生产,线程池一切上下文丢了,异步队列一满日志静默丢弃,脱敏策略改个配置还得重启服务。等监管来抽…

📅 2026/11/16 15:57:31
秘塔 word 文档一键生成、AI 导出鸭批量归档,移动端内容生产力的最后一公里终于打通。

秘塔 word 文档一键生成、AI 导出鸭批量归档,移动端内容生产力的最后一公里终于打通。

安卓用户的AI内容导出困境,被一只「鸭子」解决了秘塔 word 文档一键生成、AI 导出鸭批量归档,移动端内容生产力的最后一公里终于打通。我手头有一份刚用 DeepSeek 生成的竞品分析,里面嵌套了三层表格、一段 Mermaid 流程图和十几个 LaTeX 公式…

📅 2026/11/15 9:00:34
【项目编号:project75677】【Spring Boot + MySQL】医院门诊信息管理系统:预约挂号、检查、处方与药房协同(源码可领)

【项目编号:project75677】【Spring Boot + MySQL】医院门诊信息管理系统:预约挂号、检查、处方与药房协同(源码可领)

【Spring Boot MySQL】医院门诊信息管理系统:预约挂号、检查、处方与药房协同(源码可领)医院门诊系统的核心不是某一个页面,而是患者、医生、检查人员、药房和管理员之间的协作。一个预约挂号会继续产生就诊、检查、诊疗、药品清…

📅 2026/11/15 5:12:47
MORE NEWS

更多资讯

📰

电工证基础知识考点网上查询太难?工地太忙根本没时间复习考试

电工证基础知识考点网上查询太难?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,你是不是也经常因为没时间复习而担心电工证考试不过?特别是像低压电工、高压电工这类热门证书, 电工证基础知识考点…

📰

石基镇电工证多少钱?急需特种作业证才能上岗找工作

石基镇电工证多少钱?急需特种作业证才能上岗找工作 你是不是也和我一样,手里有个电工证,却找不到合适的岗位?现在不少工地、企业、工厂都要求必须有 特种作业操作证 ,尤其是像 石基镇电工证 这样的证书,几乎是上岗的“门槛”。但问题是,…

📰

电工证的考试过程复审延期怎么办理 2026河南最新政策

电工证的考试过程复审延期怎么办理 2026河南最新政策 证书过期了不知道怎么复审延期?你不是一个人。2026年河南最新政策已经明确,特种作业操作证的复审流程和时间安排有了新变化,如果不及时了解,可能会影响到你现有的工作,甚至面临处罚或无法上…

📰

职业电工证需要考什么官方回应来了,选对机构不被坑

职业电工证需要考什么官方回应来了,选对机构不被坑 不知道去哪报名怕被中介坑?你不是一个人。现在想考职业电工证,网上一搜就跳出一堆机构,有的打着“包过”“速成班”旗号,结果考下来发现证不正规,甚至根本不能查。其实, 官方回应…

📰

盘锦电工证哪里报名?官方报名入口全攻略,别再交冤枉钱了

盘锦电工证哪里报名?官方报名入口全攻略,别再交冤枉钱了 怕考不过白交培训费?你不是一个人。盘锦电工证哪里报名成了很多电工、维修工、工地电工最头疼的问题,特别是现在电工证越来越重要,没有证连干都干不了。别急,本文就从 官方报名入口…

📰

物业电工证有效吗通过率揭秘:周口中小施工企业负责人必看的备考攻略

物业电工证有效吗通过率揭秘:周口中小施工企业负责人必看的备考攻略 工地太忙根本没时间复习考试,这是很多周口中小型施工企业负责人的真实写照。尤其是像物业电工证这类涉及安全操作的证书,如果拿不到,不仅影响项目进度,还可能面临停工整改。那问题来了…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬