团队开发项目开发规范Word文档格式.doc
《团队开发项目开发规范Word文档格式.doc》由会员分享,可在线阅读,更多相关《团队开发项目开发规范Word文档格式.doc(10页珍藏版)》请在冰豆网上搜索。
当表达式超出或即将超出规定的列宽,遵循以下规则进行换行
a)在逗号后换行;
b)在操作符前换行;
c)规则a优先于规则b。
2.3缩进
缩进应该是每行一个Tab(4个空格),不要在代码中使用Tab字符。
2.4空行
空行是为了将逻辑上相关联的代码分块,以便提高代码的可阅读性。
在代码中,不能包含多个空行。
在以下情况下使用一个空行:
1、方法与方法、属性与属性之间。
2、方法中变量声明与语句之间。
3、方法与方法之间。
4、方法中不同的逻辑块之间。
5、方法中的返回语句与其他的语句之间。
6、属性与方法、属性与字段、方法与字段之间。
7、注释与它注释的语句间不空行,但与其他的语句间空一行。
2.5空格
在以下情况中要使用到空格:
1、关键字和左括符“(”应该用空格隔开。
如while(true)
注意:
在方法名和左括符“(”之间不要使用空格,这样有助于辨认代码中的方法调用与关键字。
2、多个参数用逗号隔开,每个逗号后都应加一个空格。
3、除了.之外,所有的二元操作符都应用空格与它们的操作数隔开。
一元操作符、++及--与操作数间不需要空格。
如
//字符测试0opxXnNjgasqwMm1lI
a+=c+d;
a=(a+b)/(c*d);
while(d++=s++)
{
n++;
}
Response.Write(“sizeis“+size);
4、语句中的表达式之间用空格隔开。
如for(expr1;
expr2;
expr3)
2.6括号-()
1、左括号“(”不要紧靠关键字,中间用一个空格隔开。
2、左括号“(”与方法名之间不要添加任何空格。
3、没有必要的话不要在返回语句中使用()。
if(condition)
Array.Remove
(1)
return1
2.7花括号-{}
1、左花括号“{”放于关键字或方法名的下一行并与之对齐。
publicintAdd(intx,inty)
2、左花括号“{”要与相应的右花括号“}”对齐。
3、通常情况下左花括号“{”单独成行,不与任何语句并列一行。
4、if、while、do语句后一定要使用{},即使{}号中为空或只有一条语句。
if(somevalue==1)
somevalue=2
5、右花括号“}”后建议加一个注释以便于方便的找到与之相应的{。
while(condition)
if(condition)
}
else
}//if
}//while
代码注释
城
3.1注释概述
1、修改代码时,总是使代码周围的注释保持最新。
2、在每个例程的开始,提供标准的注释样本以指示例程的用途、假设和限制很有帮助。
注释样本应该是解释它为什么存在和可以做什么的简短介绍.
3、避免在代码行的末尾添加注释;
行尾注释使代码更难阅读。
不过在批注变量声明时,行尾注释是合适的;
在这种情况下,将所有行尾注释在公共制表位处对齐。
4、避免杂乱的注释,如一整行星号。
而是应该使用空白将注释同代码分开。
5、避免在块注释的周围加上印刷框。
这样看起来可能很漂亮,但是难于维护。
6、在部署发布之前,移除所有临时或无关的注释,以避免在日后的维护工作中产生混乱。
7、如果需要用注释来解释复杂的代码节,请检查此代码以确定是否应该重写它。
尽一切可能不注释难以理解的代码,而应该重写它。
尽管一般不应该为了使代码更简单以便于人们使用而牺牲性能,但必须保持性能和可维护性之间的平衡。
8、在编写注释时使用完整的句子。
注释应该阐明代码,而不应该增加多义性。
9、在编写代码时就注释,因为以后很可能没有时间这样做。
另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后或许就不明显了。
10、避免多余的或不适当的注释,如幽默的不主要的备注。
11、使用注释来解释代码的意图。
它们不应作为代码的联机翻译。
12、注释代码中不十分明显的任何内容。
13、为了防止问题反复出现,对错误修复和解决方法代码总是使用注释,尤其是在团队环境中。
14、对由循环和逻辑分支组成的代码使用注释。
这些是帮助源代码读者的主要方面。
15、在整个应用程序中,使用具有一致的标点和结构的统一样式来构造注释。
16、用空白将注释同注释分隔符分开。
在没有颜色提示的情况下查看注释时,这样做会使注释很明显且容易被找到。
17、在所有的代码修改处加上修改标识的注释。
18、为了是层次清晰,在闭合的右花括号后注释该闭合所对应的起点。
namespaceOursss.ManagerPaper.Web
}//namespaceOursss.ManagerPaper.Web
3.2文件注释
在每个文件头必须包含以下注释说明
//名称:
XXX
//Copyright(c)DriveTOP.Allrightsreserved.
//作者:
RennErann
//创建日期:
2011-03-21
//功能描述:
//------------------------------------------------------
//修改人:
×
//修改时间:
yyyy-mm-dd
//修改描述:
//版本:
2.0.110321
注意:
文件功能描述只需简述,具体详情在类的注释中描述。
创建标识和修改标识由创建或修改人员的拼音或英文名。
如:
RennErann。
一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。
在所有的代码修改处加上修改标识的注释。
3.3文档型注释
该类注释采用.Net已定义好的Xml标签来标记,在声明接口、类、方法、属性、字段都应该使用该类注释,以便代码完成后直接生成代码文档,让别人更好的了解代码的实现和接口。
1、类、接口注释
///<
summary>
///类功能的说明
/summary>
seecref="
"
>
<
/see>
remarks>
///创建人:
///创建日期:
///修改人:
iflash50
///修改日期:
///修改备注:
无
///版本:
1.0
/remarks>
publicclassCountersModuleInitializer:
ModuleInitializer
标签根据具体情况选择有无
2、方法、事件注释
///根据应聘人员ID获得应聘人员信息
paramname="
applyId"
应聘人员ID<
/param>
exceptioncref="
System.Exception"
系统异常<
/exception>
returns>
应聘人员姓名<
/returns>
1.1
publicstringGeApplyNameById(intapplyId)
try
return"
李山"
;
catch(System.Exception)
throw;
该方法注释中的<
param>
、<
"
等标签根据具体情况选择有无,方法初始版本为1.0,每次改动增加0.1。
3、属性、常量注释
///sessionid
publicconststringSESSION_ID="
3.4单行注释
该类注释用于
1方法内的代码注释。
如变量的声明、代码或代码段的解释。
注释示例:
//注释语句
privateintnumber;
2方法内变量的声明或花括号后的注释,注释示例:
if(true)//alwaystrue
return1;
}
else //alwaysfalse
3.5JavaScript注释
a)注释符号
‘//’
不允许使用‘/**/’作注释符。
b)函数注释
每个函数都应该描述该函数的名称、功能、作用范围、入口参数的类型和传值方式及参数含义、返回值类型及返回值的含义。
格式如下:
//
//Function:
函数名
//Purpose:
用途
//Scope:
作用范围
//Args:
入口参数(列表)类型传值方式含义
//Returns:
返回值类型(可确定值列表)含义
c)非函数注释
注明该模块的作用。
//功能:
d)程序行间注释
在程序行的每一个处理单元前作注释。
//注释
e)注释举例
//
F_FindObject
按照空间名在可视化主对象中查找住对象内的可视化控件
Public
is_nameStringvalue:
要查找的空间名
//ipbo_objectObjectvalue:
可视化主对象
BooleanTrue表示找到该控件
//False表示没有找到该控件
functionF_FindObject(is_name,ipbo_object)