软件编程规范总结

《软件编程规范总结》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、软件编程规范总结本规范的内容包括：基本原则、布局、注释、命名规则、变量常量与类型、表达式与语句、函数与过程、可靠性、可测性、断言与错误处理等。—.基本原则1.保持代码的简明清晰，避免过分的编程技巧。2.所有的代码尽量遵循ANSIC标准。3.编程时首先达到正确性，其次考虑效率。4.避免或少用全局变量。5.尽量避免使用GOTO语句。6.尽可能重用、修正老的代码。7.尽量减少同样的错误出现的次数。二.文件布局1.头文件必须要避免重复包含。2.包含标准库头文件用尖括号<>,包含非标准库头文件用双引号“3.遵循统一的顺序书

2、写类的定义及实现。类的定义（在定义文件屮）按如下顺序书写:公有属性公有函数保护属性保护函数私有属性私有函数类的实现（在实现文件屮）按如下顺序书写：构造函数析构函数公有函数保护函数私有函数4.程序中一行的代码和注释不能超过80列。5.定义指针类型的变量，*应放在变量前。6.源程序中关系较为紧密的代码应尽可能相邻。iLength=10;iWidth二5;//矩形的长与宽关系较密切，放在一起。StrCaption="Test";7.禁止使用TAB键，必须使用空格进行缩进。缩进为4个空格。8.程序的分界符'｛'和'｝'应

3、独占一行并且位于同一列，同时与引用它们的语句左对齐。｛｝之内的代码块使用缩进规则对齐。1.if、else>elseif、for、while、do等语句自占一行，执行语句不得紧跟其后。不论执行语句有多少都要加｛｝。if（variblel

4、对齐。14.在switch语句中，每一个case分支和default要用｛｝括起來，｛｝中的内容需要缩进。15.不同逻辑程序块之间要使用空行分隔。16.一元操作符如“！”、“++”、“一”、“*”、“&”（地址运算符）等前后不加空格。“[]”、这类操作符前后不加空格。17.多元运算符和它们的操作数之间至少需要一个空格。18.关键字之后要留空格o（ifsfor.while等关键字之后应留一个空格再跟左扌舌号'（'，以突出关键字。）19.函数名之后不要留空格。（函数名后紧跟左括号'（'，以与关键字区别。）20.（'向

5、后紧跟，'）'、'，'、'；'向前紧跟，紧跟处不留空格。'，'之后要留空格。'；'不是行结束符号时其后要留空格。21.长表达式（超过80列）要在低优先级操作符处拆分成新行，操作符放在新行Z首（以便突出操作符）。拆分出的新行要进行适当的缩进，使排版整齐。22.函数声明时，类型与名称不允许分行书写。三、注释1.一般情况下，源程序有效注释量必须在20%以上。2.注释符与注释内容之间要用一个空格进行分隔。3.文件头部必须进行注释，包括：.h文件、.c文件、.cpp文件、.inc文件、.def文件、编译说明文件・cfg等。

6、4.函数头部应进行注释，列出：函数的目的/功能、输入参数、输出参数、返冋值、访问和修改的表、修改信息等。5.包含在｛｝中代码块的结束处应加注释，便于阅读。特别是多分支、多重嵌套的条件语句或循环语句。voidMain（）｛if（...）while(...)}/*endofif（...）*///指明是哪条语句结束}/*endofvoidmain（）*///指明函数的结束1.保证代码和注释的一致性。修改代码同吋修改相应的注释，不再有用的注释要删除。2.注释应与其描述的代码相近，对代码的注释应放在其上方或右方（对单条语句

7、的注释）相邻位置，不可放在下面，如放于上方则需与其上面的代码用空行隔开。&全局变量要有详细的注释，包括对其功能、取值范圉、访问信息及访问时注意事项等的说明。9.注释与所描述内容进行同样的缩排。10.对分支语句（条件分支、循环语句等）必须编写注释。11.尽量避免在注释中使用缩写，特别是不常用缩写。四、命名规则1.标识符要采用英文单词或其组合，便于记忆和阅读，切忌使用汉语拼音來命名。严格禁止使用连续的下划线，下划线也不能出现在标识符头或结尾（预编译开关除外）。2.程序屮不要出现仅靠大小写区分的相似的标识符。3.用正确

8、的反义词组命名具有互斥意义的变量或相反动作的函数等。4.宏、常量名都要使用大写字母，用下划线分割单词。预编译开关的定义使用下划线开始。5.变量名长度应小于31个字符，以保持与ANSIC标准一致。不得取单个字符（如i、j、k等）作为变量名，但是局部循坏变量除外。6.程序中局部变量不要与全局变量重名。7.使用一致的前缀来区分变量的作用域。g_:全局变量s_:模块内静态变量空：