A.3 标识符命名
3-1:标识符的命名要清晰、明了,有明确含义,同时使用完整的单词或大家基本可以理解的缩写,避免使人产生误解。
3-2:命名中若使用特殊约定或缩写,则要有注释说明。
3-3:自己特有的命名风格,要自始至终保持一致,不可来回变化。
3-4:对于变量命名,禁止取单个字符(如i、j、k...),建议除了要有具体含义外,还能表明其变量类型、数据类型等,但i、j、k作局部循环变量是允许的。
3-5:命名规范必须与所使用的系统风格保持一致,并在同一项目中统一,比如采用UNIX的全小写加下划线的风格或大小写混排的方式,不要使用大小写与下划线混排的方式。
A.4 可读性
4-1:注意运算符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级。
4-2:避免使用不易理解的数字,用有意义的标识来替代。涉及物理状态或者含有物理意义的常量,不应直接使用数字,必须用有意义的枚举或宏来代替。
A.5 变量
5-1:去掉没必要的公共变量。
5-2:仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。
5-3:明确公共变量与操作此公共变量的函数或过程的关系,如访问、修改及创建等。
5-4:当向公共变量传递数据时,要十分小心,防止赋与不合理的值或越界等现象发生。
5-5:防止局部变量与公共变量同名。
5-6:严禁使用未经初始化的变量作为右值。
A.6 函数、过程
6-1:对所调用函数的错误返回码要仔细、全面地处理。
6-2:明确函数功能,精确(而不是近似)地实现函数设计。
6-3:编写可重入函数时,应注意局部变量的使用(如编写C/C++语言的可重入函数时,应使用auto即缺省态局部变量或寄存器变量)。
6-4:编写可重入函数时,若使用全局变量,则应通过关中断、信号量(即P、V操作)等手段对其加以保护。
A.7 可测性
7-1:在同一项目组或产品组内,要有一套统一的为集成测试与系统联调准备的调测开关及相应打印函数,并且要有详细的说明。
7-2:在同一项目组或产品组内,调测打印出的信息串的格式要有统一的形式。信息串中至少要有所在模块名(或源文件名)及行号。
7-3:编程的同时要为单元测试选择恰当的测试点,并仔细构造测试代码、测试用例,同时给出明确的注释说明。测试代码部分应作为(模块中的)一个子模块,以方便测试代码在模块中的安装与拆卸(通过调测开关)。
7-4:在进行集成测试/系统联调之前,要构造好测试环境、测试项目及测试用例,同时仔细分析并优化测试用例,以提高测试效率。
7-5:使用断言来发现软件问题,提高代码可测性。
7-6:用断言来检查程序正常运行时不应发生但在调测时有可能发生的非法情况。
7-7:不能用断言来检查最终产品肯定会出现且必须处理的错误情况。
7-8:对较复杂的断言加上明确的注释。
7-9:用断言确认函数的参数。
7-10:用断言保证没有定义的特性或功能不被使用。
7-11:用断言对程序开发环境(OS/Compiler/Hardware)的假设进行检查。
7-12:正式软件产品中应把断言及其它调测代码去掉(即把有关的调测开关关掉)。
7-13:在软件系统中设置与取消有关测试手段,不能对软件实现的功能等产生影响。
7-14:用调测开关来切换软件的DEBUG版和正式版,而不要同时存在正式版本和DEBUG版本的不同源文件,以减少维护的难度。
文章来源于领测软件测试网 https://www.ltesting.net/