1、清晰第一:
清晰性是易于维护、易于重构的程序必需具备的特征(如头优秀的代码可以自我解释,不通过注释即可轻易读懂/头文件中适合放置接口的声明,不适合放置实现/除了常见的通用缩写以外,不使用单词缩写,不得使用汉语拼音)。
2、简洁为美:
简洁就是易于理解并且易于实现。废弃的代码(没有被调用的函数和全局变量)要及时清除,重复代码应该尽可能提炼成函数。
3、选择合适的风格,与代码原有风格保持一致。
4、编写整洁函数,同时把代码有效组织起来:代码简单直接、不隐藏设计者的意图、用干净利落的抽象和直截了当的控制语句将函数有机组织起来。
a.函数不变参数使用const:不变的值更易于理解/跟踪和分析,把const作为默认选项,在编译时会对其进行检查,使代码更牢固/更安全。
b.在源文件范围内声明和定义的所有函数,除非外部可见,否则应该增加static关键字:如果一个函数只是在同一文件中的其他地方调用,那么就用static声明。使用static确保只是在声明它的 文件中是可见的,并且避免了和其他文件或库中的相同标识符发生混淆的可能性
5、标识符的命名要清晰、明了,有明确含义:尽可能给出描述性名称,不要节约空间,让别人很快理解你的代码更重要。
6、变量命名规范:
a.全局变量应增加“g_”前缀
b.静态变量应增加“s_”前缀
c.禁止使用单字节命名变量,但允许定义i、j、k作为局部循环变量
7、代码质量保证优先原则:
a.正确性,指程序要实现设计要求的功能。
b.简洁性,指程序易于理解并且易于实现。
c.可维护性,指程序被修改的能力,包括纠错、改进、新需求或功能规格变化的适应能力。
8、提高程序效率:
在保证软件系统的正确性、简洁、可维护性、可靠性及可测性的前提下,提高代码效率。
华为c++编码规范
于 2024-09-04 22:21:39 首次发布