Unity3D 编程规范总结.docx
《Unity3D 编程规范总结.docx》由会员分享,可在线阅读,更多相关《Unity3D 编程规范总结.docx(19页珍藏版)》请在冰豆网上搜索。
Unity3D编程规范总结
Unity3D个人编程规范总结
[摘要:
若是脚本是继承MonoBehaviour
1.变量名应用大写开首定名。
如CanOpen。
2.组件工具定名应用组件大写缩写称号开首_.如Go_Button。
3.函数的参数应用小写字母开首定名。
如messageData。
4.函数的参]
如果脚本是继承MonoBehaviour
1.变量名使用大写开头命名。
如CanOpen。
2.组件对象命名使用组件大写缩写名称开头+_.如Go_Button。
3.函数的参数使用小写字母开头命名。
如messageData。
4.函数的参数如果是组件对象,使用组件缩写小写字母+_+名称。
如go_myMj。
5.函数中新创建的临时变量使用_开头+小写字母开头,如_dataString。
6.函数中新创建的组件对象使用_+组件缩写小写字母+_+名称命名。
如_mtrl_loginPanel。
7.场景中如果使用是UI界面的组件,命名方式参照第二条。
如果脚本不是继承MonoBehaviour
8.a)类
9.【规则1-1】使用Pascal规则命名类名,即首字母要大写。
10.【规则1-2】使用能够反映类功能的名词或名词短语命名类。
11.【规则1-3】不要使用“I”、“C”、“_”等特定含义前缀。
12.【规则1-4】自定义异常类应以Exception结尾。
13.【规则1-5】文件名要能反映类的内容,最好是和类同名。
14.b)类字段
15.【规则2-1】用camel规则来命名类成员变量名称,即首单词(或单词缩写)小写。
16.【规则2-2】类字段变量名前可加“_”前缀。
17.【规则2-3】坚决禁止在普通变量前加“m_”(这是VC老命名规则)。
18.c)方法
19.【规则3-1】方法名采用Pascal规则,第一个字符要大写。
20.【规则3-2】方法名应使用动词或动词短语。
21.【规则3-3】类中访问修饰符或功能相同的方法应该放在一起,且公共或实现接口的方法在前。
22.d)属性
23.【规则4-1】使用名词定义属性,属性使用Pascal规则,首字符大写。
24.【规则4-2】属性和相应字段名称要关联,可以使用“重构”菜单来生成属性。
25.e)参数
26.【规则5-1】参数采用camel规则命名,且首字符小写。
27.【规则5-2】使用描述性参数名称,参数名称应当具有最够的说明性。
28.【规则5-3】不要给参数加匈牙利语类型表示法的前缀。
29.【规则5-4】检查方法所有输入参数的有效性。
30.f)常量
31.【规则6-1】只读常量使用Pascal命名规则,即首字母大写。
32.【规则6-2】枚举名使用Pascal规则命名,枚举成员本质属于常量,命名规则同上。
33.【规则6-3】枚举值从小到大顺序定义。
34.【规则6-4】静态字段或属性采用Pascal规则,即首字符大写。
35.g)事件
36.【规则8-1】委托名称采用Pascal规则,即首字符大写。
37.【规则8-2】定义事件的委托要使用EventHandler后缀,且包括sender和e两个参数。
38.【规则8-3】事件用到的参数类,名称要带EventArgs后缀。
二
unity3D之C#命名规则与风格
时间:
2014-10-2523:
09来源:
互联网作者:
脚印浏览:
2120次收藏挑错推荐打印
1.文件命名组织1-1文件命名
1.文件名遵从Pascal命名法,无特殊情况,扩展名小写。
2.使用统一而又通用的文件扩展名:
C#类.cs
1-2文件注释1.在每个文件头必须包含以下注释说明
1在每个文件头必须包含以下注释说明
/*----------------------------------------------------------------
//Copyright(C)2004软件有限公司
//版权所有。
//
//文件名:
//文件功能描述:
//
//
//创建标识:
//
//修改标识:
//修改描述:
//
//修改标识:
//修改描述:
//----------------------------------------------------------------*/
文件功能描述只需简述,具体详情在类的注释中描述。
创建标识和修改标识由创建或修改人员的拼音或英文名加日期组成。
如:
Jiekengxu20040408
一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。
在所有的代码修改处加上修改标识的注释。
2.代码外观
2-1列宽代码列宽控制在110字符左右。
2-2换行当表达式超出或即将超出规定的列宽,遵循以下规则进行换行
1、在逗号后换行。
2、在操作符前换行。
3、规则1优先于规则2。
当以上规则会导致代码混乱的时候自己采取更灵活的换行规则。
2-3缩进缩进应该是每行一个Tab(4个空格),不要在代码中使用Tab字符。
VisualStudio.Net设置:
工具->选项->文本编辑器->C#->制表符->插入空格
2-4空行空行是为了将逻辑上相关联的代码分块,以便提高代码的可阅读性。
在以下情况下使用两个空行
1、接口和类的定义之间。
2、枚举和类的定义之间。
3、类与类的定义之间。
在以下情况下使用一个空行
1、方法与方法、属性与属性之间。
2、方法中变量声明与语句之间。
3、方法与方法之间。
4、方法中不同的逻辑块之间。
5、方法中的返回语句与其他的语句之间。
6、属性与方法、属性与字段、方法与字段之间。
7、注释与它注释的语句间不空行,但与其他的语句间空一行。
2-5空格在以下情况中要使用到空格
1、关键字和左括符“(”应该用空格隔开。
如
while(true)
注意在方法名和左括符“(”之间不要使用空格,这样有助于辨认代码中的方法调用与关键字。
2、多个参数用逗号隔开,每个逗号后都应加一个空格。
3、除了.之外,所有的二元操作符都应用空格与它们的操作数隔开。
一元操作符、++及--与操作数间不需要空格。
如
a+=c+d;
a=(a+b)/(c*d);
while(d++=s++)
{
n++;
}
PrintSize(“sizeis“+size+“\n”);
4、语句中的表达式之间用空格隔开。
如
for(expr1;expr2;expr3)
2-6括号-()1、左括号“(”不要紧靠关键字,中间用一个空格隔开。
2、左括号“(”与方法名之间不要添加任何空格。
3、没有必要的话不要在返回语句中使用()。
如
if(condition)
Array.Remove
(1)
return1
2-7花括号-{}1、左花括号“{”放于关键字或方法名的下一行并与之对齐。
如
if(condition)
{
}
publicintAdd(intx,inty)
{
}
2、左花括号“{”要与相应的右花括号“}”对齐。
3、通常情况下左花括号“{”单独成行,不与任何语句并列一行。
4、if、while、do语句后一定要使用{},即使{}号中为空或只有一条语句。
如
if(somevalue==1)
{
somevalue=2;
}
5、右花括号“}”后建议加一个注释以便于方便的找到与之相应的{。
如
while
(1)
{
if(valid)
{
}//ifvalid
else
{
}//notvalid
}//endforever
3.程序注释3-1注释概述1、修改代码时,总是使代码周围的注释保持最新。
2、在每个例程的开始,提供标准的注释样本以指示例程的用途、假设和限制很有帮助。
注释样本应该是解释它为什么存在和可以做什么的简短介绍.
3、避免在代码行的末尾添加注释;行尾注释使代码更难阅读。
不过在批注变量声明时,行尾注释是合适的;在这种情况下,将所有行尾注释在公共制表位处对齐。
4、避免杂乱的注释,如一整行星号。
而是应该使用空白将注释同代码分开。
5、避免在块注释的周围加上印刷框。
这样看起来可能很漂亮,但是难于维护。
6、在部署发布之前,移除所有临时或无关的注释,以避免在日后的维护工作中产生混乱。
7、如果需要用注释来解释复杂的代码节,请检查此代码以确定是否应该重写它。
尽一切可能不注释难以理解的代码,而应该重写它。
尽管一般不应该为了使代码更简单以便于人们使用而牺牲性能,但必须保持性能和可维护性之间的平衡。
8、在编写注释时使用完整的句子。
注释应该阐明代码,而不应该增加多义性。
9、在编写代码时就注释,因为以后很可能没有时间这样做。
另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后或许就不明显了。
10、避免多余的或不适当的注释,如幽默的不主要的备注。
11、使用注释来解释代码的意图。
它们不应作为代码的联机翻译。
12、注释代码中不十分明显的任何内容。
13、为了防止问题反复出现,对错误修复和解决方法代码总是使用注释,尤其是在团队环境中。
14、对由循环和逻辑分支组成的代码使用注释。
这些是帮助源代码读者的主要方面。
15、在整个应用程序中,使用具有一致的标点和结构的统一样式来构造注释。
16、用空白将注释同注释分隔符分开。
在没有颜色提示的情况下查看注释时,这样做会使注释很明显且容易被找到。
17、在所有的代码修改处加上修改标识的注释。
18、为了是层次清晰,在闭合的右花括号后注释该闭合所对应的起点。
namespaceLangchao.Procument.Web
{
}//namespaceLangchao.Procument.Web
3-2文档型注释该类注释采用.Net已定义好的Xml标签来标记,在声明接口、类、方法、属性、字段都应该使用该类注释,以便代码完成后直接生成代码文档,让别人更好的了解代码的实现和接口。
如
///MyMethodisamethodintheMyClassclass.
///Here'showyoucouldmakeasecondparagraphinadescription.
///
///forinformationaboutoutputstatements.
///
///
///
publicstaticvoidMyMethod(intInt1)
{
}
3-3单行注释该类注释用于
1方法内的代码注释。
如变量的声明、代码或代码段的解释。
注释示例:
//
//注释语句
//
privateintnumber;
或
//注释语句
privateintnumber;
2方法内变量的声明或花括号后的注释,注释示例:
if(1==1)//alwaystrue
{
statement;
}//alwaystrue
3-4注释标签
标签用法作用c>texttext希望将其指示为代码的文本。
为您提供了一种将说明中的文本标记为代码的方法。
使用将多行指示为代码contentcontent段落文本。
用于诸如或等标记内,使您得以将结构添加到文本中。
descriptionname为方法参数名。
将此名称用单引号括起来('')。
应当用于方法声明的注释中,以描述方法的一个参数。
name要引用的参数名。
将此名称用双引号括起来("")。
标记为您提供了一种指示词为参数的方法。
可以处理XML文件,从而用某种独特的方法格式化该参数。
cref="member"对可以通过当前编译环境进行调用的成员或字段的引用。
编译器检查到给定代码元素存在后,将member传递给输出XML中的元素名。
必须将member括在双引号("")中。
使您得以从文本内指定链接。
使用指示希望在“请参阅”一节中出现的文本。
cref="member"对可以通过当前编译环境进行调用的成员或字段的引用。
编译器检查到给定代码元素存在后,将member传递给输出XML中的元素名。
必须将member括在双引号("")中使您得以指定希望在“请参阅”一节中出现的文本。
使用从文本descriptiondescription代码示例的说明。
使用标记可以指定使用方法或其他库成员的示例。
一般情况下,这将涉及到标记的使用。
content
content为希望将其标记为代码的文本。
记为您提供了一种将多行指示为代码的方法。
使用指示应将说明中的文本标记为代码description此处description为对象的摘要。
应当用于描述类型成员。
使用以提供有关类型本身的信息。
descriptioncref="member"对可从当前编译环境中获取的异常的引用。
编译器检查到给定异常存在后,将member转换为输出XML中的规范化元素名。
必须将member括在双引号("")中。
description说明。
标记使您可以指定类能够引发的异常。
filename包含文档的文件名。
该文件名可用路径加以限定。
将filename括在单引号中('')。
Tagpath:
filename中指向标记名的标记路径。
将此路径括在单引号中('')。
name注释前边的标记中的名称说明符;名称具有一个id。
id位于注释之前的标记的id。
将此id括在双引号中("")。
标记使您得以引用描述源代码中类型和成员的另一文件中的注释。
这是除了将文档注释直接置于源代码文件中之外的另一种可选方法。
标记使用XMLXPath语法。
有关自定义使用的方法,请参阅XPath文档。
termdescription- termdescription
term定义的项,该项将在text中定义。
description目符号列表或编号列表中的项或者term的定义。
块用于定义表或定义列表中的标题行。
定义表时,只需为标题中的项提供一个项。
列表中的每一项用- 块指定。
创建定义列表时,既需要指定term也需要指定text。
但是,对于表、项目符号列表或编号列表,只需为text提供一个项。
列表或表所拥有的- 块数可以根据需要而定。
descriptioncref="member"对可以通过当前编译环境进行调用的成员或字段的引用。
编译器检查到给定代码元素存在后,将member转换为输出XML中的规范化元素名。
必须将member括在双引号("")中。
description成员的访问的说明。
标记使您得以将成员的访问记入文档。
System.Security.PermissionSet使您得以指定对成员的访问。
descriptiondescription成员的说明。
标记是可以指定有关类或其他类型的概述信息的位置。
是可以描述该类型的成员的位置。
descriptiondescription返回值的说明。
标记应当用于方法声明的注释,以描述返回值。
property-descriptionproperty-description属性的说明。
标记使您得以描述属性。
请注意,当在VisualStudio.NET开发环境中通过代码向导添加属性时,它将会为新属性添加标记。
然后,应该手动添加标记以描述该属性所表示的值。
4.申明4-1每行声明数一行只建议作一个声明,并按字母顺序排列。
如
intlevel;//推荐
intsize;//推荐
intx,y;//不推荐
4-2初始化建议在变量声明时就对其做初始化。
4-3位置变量建议置于块的开始处,不要总是在第一次使用它们的地方做声明。
如
voidMyMethod()
{
intint1=0;//beginningofmethodblock
if(condition)
{
intint2=0;//beginningof"if"block
...
}
}
不过也有一个例外
for(inti=0;i{
...
}
应避免不同层次间的变量重名,如
intcount;
...
voidMyMethod()
{
if(condition)
{
intcount=0;//避免
...
}
...
}
4-4类和接口的声明1在方法名与其后的左括号间没有任何空格。
2左花括号“{”出现在声明的下行并与之对齐,单独成行。
3方法间用一个空行隔开。
4-5字段的声明不要使用是public或protected的实例字段。
如果避免将字段直接公开给开发人员,可以更轻松地对类进行版本控制,原因是在维护二进制兼容性时字段不能被更改为属性。
考虑为字段提供get和set属性访问器,而不是使它们成为公共的。
get和set属性访问器中可执行代码的存在使得可以进行后续改进,如在使用属性或者得到属性更改通知时根据需要创建对象。
下面的代码示例阐释带有get和set属性访问器的私有实例字段的正确使用。
示例:
publicclassControl:
Component
{
privateinthandle;
publicintHandle
{
get
{
returnhandle;
}
}
}
5.命名规范5-1命名概述名称应该说明“什么”而不是“如何”。
通过避免使用公开基础实现(它们会发生改变)的名称,可以保留简化复杂性的抽象层。
例如,可以使用GetNextStudent(),而不是GetNextArrayElement()。
命名原则是:
选择正确名称时的困难可能表明需要进一步分析或定义项的目的。
使名称足够长以便有一定的意义,并且足够短以避免冗长。
唯一名称在编程上仅用于将各项区分开。
表现力强的名称是为了帮助人们阅读;因此,提供人们可以理解的名称是有意义的。
不过,请确保选择的名称符合适用语言的规则和标准。
以下几点是推荐的命名方法。
1、避免容易被主观解释的难懂的名称,如方面名AnalyzeThis(),或者属性名xxK8。
这样的名称会导致多义性。
2、在类属性的名称中包含类名是多余的,如Book.BookTitle。
而是应该使用Book.Title。
3、只要合适,在变量名的末尾或开头加计算限定符(Avg、Sum、Min、Max、Index)。
4、在变量名中使用互补对,如min/max、begin/end和open/close。
5、布尔变量名应该包含Is,这意味着Yes/No或True/False值,如fileIsFound。
6、在命名状态变量时,避免使用诸如Flag的术语。
状态变量不同于布尔变量的地方是它可以具有两个以上的可能值。
不是使用documentFlag,而是使用更具描述性的名称,如documentFormatType。
(此项只供参考)
7、即使对于可能仅出现在几个代码行中的生存期很短的变量,仍然使用有意义的名称。
仅对于短循环索引使用单字母变量名,如i或j。
可能的情况下,尽量不要使用原义数字或原义字符串,如
Fori=1To7。
而是使用命名常数,如Fori=1ToNUM_DAYS_IN_WEEK以便于维护和理解。
5-2大小写规则大写
标识符中的所有字母都大写。
仅对于由两个或者更少字母组成的标识符使用该约定。
例如:
System.IO
System.Web.UI
下表汇总了大写规则,并提供了不同类型的标识符的示例。
标识符大小写示例类PascalAppDomain枚举类型PascalErrorLevel枚举值PascalFatalError事件PascalValueChange异常类PascalWebException注意总是以Exception后缀结尾。
只读的静态字段PascalRedValue接口PascalIDisposable注意总是以I前缀开始。
方法PascalToString命名空间PascalSystem.Drawing属性PascalBackColor公共实例字段PascalRedValue注意很少使用。
属性优于使用公共实例字段。
受保护的实例字段CamelredValue注意很少使用。
属性优于使用受保护的实例字段。
私有的实例字段CamelredValue参数CameltypeName方法内的变量CamelbackColor
5-3缩写为了避免混淆和保证跨语言交互操作,请遵循有关区缩写的使用的下列规则:
1不要将缩写或缩略形式用作标识符名称的组成部分。
例如,使用GetW