软件开发代码规范C版.docx
- 文档编号:3141964
- 上传时间:2022-11-18
- 格式:DOCX
- 页数:12
- 大小:22.07KB
软件开发代码规范C版.docx
《软件开发代码规范C版.docx》由会员分享,可在线阅读,更多相关《软件开发代码规范C版.docx(12页珍藏版)》请在冰豆网上搜索。
软件开发代码规范C版
文档编号
版本
密级
本部门开放
工作规范
共14页
软件开发代码规范(C#版)
拟制:
日期:
2007-2-13
审核:
日期:
审核:
日期:
批准:
日期:
版权所有********有限公司
修订纪录
日期
修订版本
描述
作者
2007-2-13
初稿完成
2007-5-10
修正
2007-11-2
修正
注:
Pascal命名法则:
即名称中所有单词的第一个字母大写其他字母使用小写形式。
Camel命名法则:
即名称中第一个单词各个字母全部小写,其他部分遵循Pascal命名法则。
1、第一章命名规范
1.1、第一节总则
1.本命名规则除特殊提及外统一使用Camel命名法则。
如:
controlMenu
2.命名时尽量不使用拼音,更不可使用拼音缩写(专有名词除外)。
3.如果使用品牌名称命名时其大小写尽量保持和品牌名称一致的样式。
如:
LuX则命名时,不要写成LUX,或者Lux,而应该保持与原品牌名称风格一致使用LuX
4.使用专有名词或英文缩写命名时采用大写形式。
如:
CNNIC
5.禁止使用仅区分大小写的方式命名。
如:
Abc与abc仅用大写A来区分,这样写在类C系语言中不会出错,但是不利于系统的迁移
、第二节变量命名规范
1.2.1、CodeBehind内部命名规范
1.公有字段/属性使用Pascal命名规则,私有变量/保护变量/局部变量使用Camel命名规则,遵循动宾结构。
例:
publicclassHello
{
privatestringuserName;
privateDateTimeloginTime;
privateboolisOnline;
publicstringUserName{
get{return;}
}
}
2.即使对于可能仅出现在几个代码行中的生存期很短的变量,仍然使用意义描述性的名称。
仅对于短循环索引使用单字母变量名,如i或j
3.在变量名中使用互补对,如Min/Max、Begin/End和Open/Close。
4.当一个方法内部变量繁多的时候,可以使用Camel命名法则,其中第一个单词可以使用变量类型的缩写来说明以示区别。
例:
stringstrName;
intintAge;
objectobjPerson;
1.2.2、控件命名规范
1.控件命名使用控件缩写加名称的方式
例:
控件
缩写
声明
Label
lbl
protectedLabellblName;
TextBox
txt
protectedTextBoxtxtContent;
CheckBox
chk
protectedCheckBoxchkRight;
Button
btn
protectedButtonbtnOK;
ListBox
lbx
protectedListBoxlstItem;
DropDownList
ddl
protectedDropDownListddlArea;
?
etc.
、第三节 常量命名规范
常量名也应当有一定的意义,格式为NOUN或NOUN_VERB。
常量名均为大写,字之间用下划线分隔。
例:
privateconstboolWEB_ENABLEPAGECACHE_DEFAULT=true;
privateconstintWEB_PAGECACHEEXPIRESINSECONDS_DEFAULT=3600;
privateconstboolWEB_ENABLESSL_DEFAULT=false;
注:
变量名和常量名最多可以包含255个字符,但是,超过25到30个字符的名称比较笨拙。
此外,要想取一个有实际意义的名称,清楚地表达变量或常量的用途,25或30个字符应当足够了。
、第四节 命名空间、类、方法命名规范
1.名字应该能够标识事物的特性。
2.名字尽量不使用缩写,除非它是众所周知的。
3.名字可以有两个或三个单词组成,但通常不应多于三个。
4.使用名词或名词短语命名类。
5.尽可能少用缩写。
6.不要使用下划线字符(_)。
7.命名空间名称使用此格式:
Snda+项目名称+逻辑层名称
例:
namespaceclassFileStream
{
publicvoidInPut(stringpara)
{}
}
}
、第五节 接口命名规范
和类命名规范相同,唯一区别是接口在名字前加上大写“I”前缀
例:
interfaceIDBCommand;
interfaceIButton;
、第六节命名规范小结
1、使用Pascal命名方式命名类、方法、属性和常量
2、使用Camel命名方式命名局部变量和方法的参数
3、接口使用Pascal命名方式,并且在前面添加“I”
4、方法命名使用动宾结构,比如ShowDialog()
5、有返回值的方法命名应有单词来描述,比如GetObjectState()
6、避免使用带命名空间的类型,尽量用using关键字
7、避免把using语句放到命名空间内
8、控件命名使用控件缩写加名称的方式
9、常量命名采用全部大写的形式,要想一个有实际意义的名称,清楚地表达常量的用途
2、第二章代码注释规范
、第一节 模块级注释规范(命名空间、类等)
模块须以以下形式书写模块注释:
1.2.2.12.2.2Para3.2.1ET库函数和公共函数(无特殊情况不要使用外部方法调用Windows的核心动态链接库API)。
2.不要随意定义全局变量,尽量使用局部变量。
3.2.2、可读性要求
1.保持注释与代码完全一致。
2.去除无效的注释
3.处理过程的每个阶段都有相关注释说明。
4.利用缩进来显示程序的逻辑结构,缩进量一致并以Tab键为单位,定义Tab为4个空格。
5.循环、分支层次不要超过五层。
6.注释可以与语句在同一行,也可以在上行,视语句的长短而定。
7.一目了然的语句不加注释。
8.注释的作用范围可以为:
定义、引用、条件分支以及一段代码。
9.去除IDE自动生成的注释,比如:
10....
11.privatevoidPage_Load(objectsender,EventArgse){
12..(删除这段注释)
13.}
3.2.3、结构化要求
1.禁止出现两条等价的支路。
2.除了在switch关键字的作用域内,禁止goto语句。
3.用if语句来强调只执行两组语句中的一组。
禁止elsegoto和elsereturn。
4.用case实现多路分支。
5.避免从循环引出多个出口。
6.函数只有一个出口。
7.尽量不使用条件赋值语句。
8.避免不必要的分支。
9.不要轻易用条件分支去替换逻辑表达式。
3.2.4、正确性与容错性要求
1.程序首先是正确,其次是优美。
2.无法证明你的程序没有错误,因此在编写完一段程序后,应先回头检查。
3.改一个错误时可能产生新的错误,因此在修改前首先考虑对其它程序的影响。
4.所有变量在调用前必须被初始化。
5.对所有的用户输入,必须进行合法性检查。
6.尽量不要比较浮点数的相等,
7.如:
*==,不可靠,因为不同CPU的浮点运算能力是不同的
8.程序与环境或状态发生关系时,必须主动去处理发生的意外事件,如文件能否逻辑锁定、打印机是否联机等,对于明确的错误,要有明确的容错代码提示用户,在这样不确定的场合都使用trythrowcatch。
9.单元测试也是编程的一部份,提交联调测试的程序必须通过单元测试。
10.尽量使用规范的容错语句.
例:
try
{}
catch
{}
finally
{}
3.2.5、可重用性要求
1.重复使用的完成相对独立功能的算法或代码应抽象为服务或类。
2.服务或类应考虑OO思想,减少外界联系,考虑独立性或封装性。
3.2.6、interface使用注意事项
1.避免一个接口中只有一个成员。
尽量使每个接口中包含3-5个成员。
接口中的成员不应该超过20个。
避免接口成员中包含事件。
2.推荐使用显式的接口实现。
3.2.7、类使用注意事项
1.避免方法的返回值是错误代码。
2.尽量定义自定义异常类。
当需要定义自定义的异常时:
a)自定义异常要继承于ApplicationException。
b)提供自定义的序列化功能。
3.只对外公布必要的操作。
4.使程序集尽量为最小化代码(EXE客户程序)。
使用类库来替换包含的商务逻辑。
5.不要提供public的成员变量,使用属性代替他们。
6.避免在继承中使用new而使用override替换。
7.在不是sealed的类中总是将public和protected的方法标记成virtual的。
8.避免显式的转换,使用as操作符进行兼容类型的转换。
例:
Dogdog=newGermanShepherd();
GermanShepherdshepherd=dogasGermanShepherd;
if(shepherd!
=null)
{…}
9.当类成员包括委托的时候在调用委托之前一定要检查它是否为null
例:
publicclassMySource
{
publiceventEventHandlerMyEvent;
publicvoidFireEvent()
{
EventHandlertemp=MyEvent;
if(temp!
=null)
{
temp(this,;
}
}
}
10.不要提供公共的事件成员变量,使用事件访问器替换这些变量。
例:
publicclassMySource
{
MyDelegatem_SomeEvent;
publiceventMyDelegateSomeEvent
{
add
{
m_SomeEvent+=value;
}
remove
{
m_SomeEvent-=value;
}
}
}
11.避免在结构里面提供方法。
建议使用参数化构造函数,可以重裁操作符。
12.类成员间调用请尽量使用this关键字。
13.除非你想重写子类中存在名称冲突的成员或者调用基类的构造函数否则不要使用base来访问基类的成员。
3.2.8、流程控制语句注意事项
1.即使if语句只有一句,也要将if语句的内容用大括号扩起来。
2.避免在条件语句中调用返回bool值的函数。
可以使用局部变量并检查这些局部变量。
例:
boolIsEverythingOK()
{…}
//避免
if(IsEverythingOK())
{…}
//替换方案
boolok=IsEvery
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 软件 开发 代码 规范