Qt项目架构经验总结.md · 神机归藏/Qt自学笔记

# Qt项目架构经验总结

版权声明：本文为CSDN博主「feiyangqingyun」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/feiyangqingyun/article/details/113985170

## （一）通用规则
除了极小的微型demo级别项目外，其余项目建议用pri分门别类不同文件夹存放代码文件，方便统一管理和查找。

同类型功能的类建议统一放在一起，如果该目录下代码文件数量过多，也建议拆分多个目录存放。

比如就3-5个界面的项目，统一搞个form.pri存放这些界面，而当项目越来越大，界面可能也需要按照功能划分，比如系统配置的窗体放在一个目录下，日志管理的窗体放在一个目录下。

很多通用功能，多个项目都会用到，可以考虑封装成pri形式的模块，俗称轮子，不断完善这些轮子，多个项目共享该模块，一旦遇到BUG修复，只需要更改一个地方就行。

项目如果还更大或者项目组人员分配不同功能，可以考虑插件形式，插件一般会用到两种，一种是普通动态库形式的插件，必须和主程序放在一起；一种是Qt机制的插件，放在指定的目录。

## （二）全局配置文件

全局配置文件管理类 appconfig.h 用来读写对应项目的配置文件。

格式可以是ini、xml、json等，小项目建议ini，怎么方便怎么来，相当于将配置文件的值映射到全局变量。

配置文件如果配置项较多建议分组存储方便查找，而不是全部放在一个大分组中。

读配置文件的时候可以判断配置文件是否存在、配置项是否缺失等情况，有问题则重新生成配置文件，避免恶意删除配置文件导致程序运行异常。

读配置文件的时候可以填入默认值（qt配置文件类QSettings的value方法的第二个参数，set.value(“Hardware”, App::Hardware)），避免初始时候读取不到节点而导致配置项值不符合预期值类型。

读配置文件完成后可以重新判断配置项的值是否符合要求，对值进行过滤和矫正，防止人为打开配置文件修改后填入了异常的值，比如定时器的间隔为0，要重新纠正设定为合法的值。

带中文的初始值用QString::fromUtf8包起来，比如QString::fromUtf8(“管理员”)。

带中文的配置项要设置配置文件编码为 utf-8，set.setIniCodec(“utf-8”)。

## （三）全局变量
全局变量管理类 appdata.h 用来设置项目中用到的所有全局变量。

比如当前用户/系统是否锁定等，这样可以在任意的编码位置使用该变量进行判断处理。

可以将UI界面中的导航栏宽高、按钮大小、图标大小等变量放在这，系统启动后判断分辨率等来设定不同的值。

## （四）全局事件中转处理
全局事件中转处理类 appevent.h 用来中转系统中各种跨多个UI以及多个类的事件。

此类必须是**全局单例类**，便于全局统一使用。

比如类a的父类是b，类b的父类是c，现在有个信号要发给类d，在没有事件中转处理的情况下的做法是将a信号发给b，b再发给c，c再发给d，如果父类嵌套层级越多越复杂，代码越难管理。

将类a的信号发给appevent类，然后类d直接关联appevent类进行处理就行。

项目越大，会越发现事件中转处理的必要性，代码清晰，管理方便。

## （五）全局程序初始化
全局程序初始化类 appinit.h 用来做一些程序启动后的初始化处理。

读取配置文件。

设置全局字体。

设置全局样式表，建议先读取通用的样式表，然后将额外的样式表内容加到后面一起设置。

设置项目编码。

设置翻译文件，可以加载多个，包括qt内置的qt_zh_CN.qm，用户自己的翻译文件等。

初始化随机数种子。

新建项目中需要的目录，防止没有目录无法保存文件到目录。

初始化数据库，包括打开数据库，载入基础数据比如用户表、设备表等。

启动日志输出类用来启动日志服务。

启动运行时间记录类用来记录每次软件运行开始时间和结束时间。

关联全局事件过滤器处理自定义无边框UI拖动、全局按键处理等。

## （六）全局通用类
调试日志输出类 savelog.h 用来启动日志服务，可以将日志输出到文件或者网络打印输出。
运行时间记录类 saveruntime.h 用来记录每次软件运行开始时间和结束时间。
图形字体类 iconfont.h 用来设置图形字体图标。

神机归藏/Qt自学笔记

简介

发行版

贡献者

近期动态

神机归藏/Qt自学笔记 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

神机归藏/Qt自学笔记