软件开发规范：编码规范

《软件开发规范：编码规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、C#编码规范目标：1.安全：代码完成所需的功能之余,不要产生负作用，即要稳定可靠。2.易读:类、实例、成员变量、成员函数的命名一目了然3.美观:尽量统一项目组内人员的编程风格。第一部分：命名1.命名原则1)所有的函数（变量/类/文件名）应该代表其实际的作用，应该使用有意义的单词或多个词组合，但不要使用人名、项目组名。2)所有的函数（变量/类名）一律使用英文。3)使用多个单词时不需要使用连线(如下划线),但对于全部大写的宏需要使用连线。4)多个词组合较长时,可以使用单词的缩写。5)不得使用非常相近的名字类表示几个不同含义的函数（变量/

2、类）。6)命名时请考虑名字的唯一性和含义的准确性。7)使用项目组专用词汇来表达特定的含义(概念),不得把专用词汇挪作他用。2.变量的命名原则:使用匈牙利命名法命名变量1)变量名一般由“类型修饰＋代表变量含意的英文单词或单词缩写”等部分组成。类型修饰(小写字母)：n:int，l:LONG/long，s:short，u:UINT，f:floatb:bool，by:BYTE，ch:char，sz:char[],str:string2)针对异常捕获过程中的Exception变量命名，在没有冲突的情况下，统一命名为e；如果有冲突的情况下，可以

3、重复e，比如：ee。3.函数的命名1)使用动宾词组表达函数实际所作的事。2)同名的函数(重载函数)在功能上应该完全相同,在参数上的差别也应一目了然。3)不得出现名字非常相近但功能不同的函数.如CreatePage1(),CreatePage2()等。4.类命名1)名字应该能够标识事物的特性。2)名字尽量不使用缩写，除非它是众所周知的。3)名字可以有两个或三个单词组成，但通常不应多于三个。4)在名字中，所有单词第一个字母大写，缩写都要大写。1)不要使用下划线字符(_)。5.控件命名规则1)控件命名=Web控件缩写前缀+“_”+变量名控

4、件LabelTextBoxButtonListBoxDropDownList等等缩写lb_XXXtb_XXXBtn_XXXLb_XXXDrd_XXXXXXXX6.文件命名1)文件起名要有实际意义。2)源文件应尽量使用8.3格式，文件名只能包含字母、数字和下划线，不得使用其他的字母。超长的文件名应使用缩写方式减少文件名的长度。建议使用如下的缩写的规则（部分情况可以有例外，视具体情况而定）：l缩写一般可以去掉元音字母以及不发音字母l单词的首字母一般应该保留。l当一个单词必须缩成一个字母时，应该选用最有代表性的字母，或首字母。l多音节的单

5、词可以去掉后面的音节而只保留前面的第一、二音节。较短的二音节单词一般不缩写，如果必须缩写，可以只保留一个字母l多个单词组成文件名时，应该保留较重要的有意义的单词（或多留几个字母），其他单词可以使用简写或只用首字母，去掉不必要的无意义的单词l可以使用一些谐音表示一个单词，如2表示to，4表示for等等，当单词数量少，字母少的情况下，不需要缩写l较短的单词一般不缩写，或缩写为一到二个字母第二部分：代码格式书写规范1.基本格式1)所有的缩进TAB键为4个空格，每个单词的首字符大写,其余小写。2)在代码中垂直对齐左括号和右括号。例：if(x

6、==0){Response.Write("用户编号必须输入！");}不允许以下情况：if(x==0){Response.Write("用户编号必须输入！");}或者：if(x==0){Response.Write("用户编号必须输入！");}3)在大多数运算符之前和之后使用空格，这样做时不会改变代码的意图却可以使代码容易阅读。例：intj=i+k;而不应写为：intj=i+k;4)编写SQL语句时，对于关键字使用全部大写，对于数据库元素（如表、列和视图）使用大小写混合。1)将每个主要的SQL子句放在不同的行上，这样更容易阅读和编辑语

7、句。2.注释的写法1)在你劳神的地方请加上详细的注释说明。除了最简单的存取成员变量的Set_/Get_成员函数之外，其余大部分的函数写上注释是良好的习惯。尽量使你的程序让别人很容易看懂2)太多的注释会使程序很难看，但一些复杂的算法和数据结构处还是要加上注释的，这样别人就容易看懂。否则时间长了，你自己都未必看明白了.3)如果是对某一段程序(算法/结构)的注释,在程序头直接用//再空一格来进行说明,一行不要超过80字符4)为了防止在阅读代码时不得不左右滚动源代码编辑器，每行代码或注释在不得超过一显示屏。5)使用连续的多个//表示注释行(

8、不要超过80字符)6)文件头部应有注释，简单描述文件的内容7)对于程序中的比较关键的算法和函数，必须加注释3．cs文件的书写1)各个部分应使用注释行和空行分割,并在必要的地方写上注释2)函数之间用注释行和空行分割3)重要的函数在函数头