C++与Qt代码质量检查规范V0.5

"C++和Qt代码质量检查表是一个公司内部使用的规范文档，旨在提升代码质量和开发标准。文档包含了评分项目，涉及注释、语法、逻辑处理和健壮性等多个方面，用于代码审核和管理。" 1. **注释规范** (10分) - 注释量至少占30%，确保注释与代码同步，且注释必须使用中文。 - 每个文件和函数声明都需包含注释。 - 单行代码的注释应置于代码右侧。 - 整块代码注释应写在上方，与上方代码用空行隔开。 - 长于10行的控制语句（如for、while、if）结束时需添加注释。 - 全局变量在定义和使用时均需注释。 - 数据结构声明时需附加注释。 - 对代码中的每个分支（if-else、switch-case）进行注释。 - 物理含义的宏和常量声明时应加以解释。 2. **语法规范** (5分) - 避免在QObject子类中使用全局的`QObject::tr()`宏。 - 容器嵌套的数据类型定义时，`>>`之间要有空格。 - 变量定义和函数返回值类型应保持一致。 - 使用`qAbs`代替`abs`或`fabs`。 - 禁止使用`foreach`语句。 - 在发送信号的地方使用`emit`宏明确标记。 - 代码中的常量应与工程定义保持一致。 3. **逻辑处理和健壮性** (60分) - 检查是否存在内存管理问题，如未释放、重复释放、越界访问和非法复制。 - 隐式内存使用问题，如数组、链表、映射等数据结构的不当使用。 - if-else语句需全面处理，通过提示界面、输出调试信息、注释说明等方式增强可读性和可维护性。 - 逻辑判断合理性，模块封装和复用要清晰明确。 - 避免将集合类型或大对象作为非引用返回值，除非特殊情况。 - 函数返回通常应使用单一出口，错误处理除外。 这份检查表不仅关注代码的正确性，还强调了代码的可读性和维护性，旨在通过严格的规范提升团队的整体开发水平。遵循这些规则，开发者可以编写出更易于理解、更健壮的C++和Qt代码，从而提高软件的质量和可靠性。