《开发代码编程命名规范分解》由会员分享，可在线阅读，更多相关《开发代码编程命名规范分解（27页珍藏版）》请在金锄头文库上搜索。
1、编码及命名规范整理人：陈春祥日 期：2011-01-04适用范围本文档适用人员范围：开发人员。本文档适用开发范围：C#开发、JAVA开发。注：本文档为使用进行开发的程序员提供编码规范的指导，其提供的一些编码通用规则也可以供使用其他语言编程的开发者参考。第一部分 命名规范1.大写样式1.1 首字母大写样式每个单词开头的字母大写(如TestCounter).1.2 首字母小写样式除了第一个单词外的其他单词的开头字母大写. 如. testCounter.1.2 全字母大写样式全部单词都大写，单词间以“_”符号隔开。尽量少用缩写命名. 如. TEST_COUNTER.2.命名指导2.1名称所有命名都应
2、该尽可能使用完整的词，例如 SpellCheck。缩写词可能有许多种形式，因此可能产生混淆。请注意：缩写词可能很难理解。如果整个单词太长，则使用完整的第一音节或经过仔细选择的缩写词。2.2区分大小写为了避免混淆和保证跨语言交互操作，请遵循有关区分大小写的使用的下列规则：1.不要使用要求区分大小写的名称。对于区分大小写和不区分大小写的语言，组件都必须完全可以使用。不区分大小写的语言无法区分同一上下文中仅大小写不同的两个名称。因此，在创建的组件或类中必须避免这种情况。2.不要创建仅是名称大小写有区别的两个命名空间。例如，不区分大小写的语言无法区分以下两个命名空间声明。 namespace ee.c
3、ummings; namespace Ee.Cummings;3.不要创建具有仅是大小写有区别的参数名称的函数。下面的示例是不正确的。 void MyFunction(string a, string A)4.不要创建具有仅是大小写有区别的类型名称的命名空间。在下面的示例中，Point p 和 POINT p 是不适当的类型名称，原因是它们仅在大小写方面有区别。 System.Windows.Forms.Point p System.Windows.Forms.POINT p5.不要创建具有仅是大小写有区别的属性名称的类型。在下面的示例中，int Color 和 int COLOR 是不适当的
4、属性名称，原因是它们仅在大小写方面有区别。 int Color get, set int COLOR get, set6.不要创建具有仅是大小写有区别的方法名称的类型。在下面的示例中，calculate 和 Calculate 是不适当的方法名称，原因是它们仅在大小写方面有区别。 void calculate() void Calculate()2.3缩写为了避免混淆和保证跨语言交互操作，请遵循有关区缩写的使用的下列规则：1.不要将缩写或缩略形式用作标识符名称的组成部分。例如，使用 GetWindow，而不要使用 GetWin。 2.不要使用计算机领域中未被普遍接受的缩写。3.在适当的时候，使
5、用众所周知的缩写替换冗长的词组名称。例如，用 UI 作为 User Interface 的缩写，用 OLAP 作为 On-line Analytical Processing 的缩写。4.不要在标识符或参数名称中使用缩写。如果必须使用缩写，对于由多于两个字符所组成的缩写请使用首字母大写样式，虽然这和单词的标准缩写相冲突。 2.4命名指导1.类名应该为名词及名词短语，尽可能使用完整的词.2.使用首字母大写样式3.不要使用类前缀4.在适当的地方，使用复合单词命名派生的类。派生类名称的第二个部分应当是基类的名称。例如，ApplicationException 对于从名为 Exception 的类派生
6、的类是适当的名称，原因是 ApplicationException 是一种 Exception。请在应用该规则时进行合理的判断。例如，Button 对于从 Control 派生的类是适当的名称。尽管按钮是一种控件，但是将 Control 作为类名称的一部分将使名称不必要地加长。 2.5接口命名规则1.接口名称应该为名词及名词短语或者描述其行为的形容词，尽可能使用完整的词. (Example IComponent or IEnumberable)2.使用首字母大写样式3.使用字符I为前缀，并紧跟一个大写字母（即接口名的第一个字母大写）2.6枚举命名规则1.对于 Enum 类型和值名称使用全字母大
7、写样式。2.少用缩写。 3.不要在 Enum类型名称上使用 Enum 后缀。 2.7只读及常量变量命名1.静态常量使用名词及名词短语2.使用全字母大写样式2.8参数及非常量变量命名1.使用描述性的命名，名称应该明确表达参数的意义及类型，优先满足参数的意义描述 2.使用首字母小写样式3.对类内的成员变量或静态变量不使用前缀。 公有成员使用首字母大写样式 私有成员使用首字母小写样式 内部成员使用首字母小写样式 静态变量使用全字母大写样式4.UI类的变量命名使用如下规则TextBox类：前缀txt+名称（首字母小写），如：txtCustomerName;Label类：前缀lbl+名称（首字母小写），
8、如：lblCustomerName;Select类：前缀sel+名称（首字母小写），如：selCustomerType;Radio类：前缀rdo+名称（首字母小写），如：rdoSubscribe;CheckBox类：前缀chk+名称（首字母小写），如：chkTVDataGrid类：前缀grd+名称（首字母小写）,如grdCustomerListButton类：前缀btn+名称(首字母小写),如：btnSubmitForm类：前缀form+名称(Pascal规则)，如：formLogin2.9变量命名1.在简单的循环语句中计数器变量使用i, j, k, l, m, 2.使用首字母小写样式 2.1
9、1属性命名1.名称应该为名词及名词短语2.使用首字母大写样式3.对于bool型属性或者变量使用Is（is）作为前缀，不要使用Flag后缀，例如应该使用IsDeleted,而不要使用DeleteFlag2.10方法命名1.使用首字母大写样式2.对方法名采用一致的动词/宾语或宾语/动词顺序。例如，将动词置于前面时，所使用的名称诸如 InsertWidget 和 InsertSprocket；将宾语置于前面时，所使用的名称诸如 WidgetInsert 和 SprocketInsert。3.推荐名称应该为动词或动词短语.例如Save，SaveCustomer，而不要使用CustomerSave4.不
10、要在方法中重复类的名称。例如，如果某个类已命名为 Book，则不要将某个方法称为 Book.CloseBook，而可以将方法命名为 Book.Close。 2.12集合命名1.名称应该为名词及名词短语2.使用首字母大写样式3.名称后面追加“Collection”2.13事件命名1.event handlers命名使用EventHandler 后缀.2.两个参数分别使用sender 及e3.使用首字母大写样式4.事件参数使用EventArgs 后缀5.事件命名使用语法时态反映其激发的状态，例如 Changed，Changing5.考虑使用动词命名.2.14实体命名1.实体名称使用全字母大写样式命
11、名.2.实体成员名称要加前缀，例如int前缀是n，string前缀是ch。使用首字母大写样式如：public struct DEVICE_ROUTE_INFO /设备ID public int nDeviceID; /接口ID public int nInterfaceID; /端口索引 public int nInterfaceIndex;2.15项目名称1、项目名称前缀要统一。例如所有备案系统的程序都用PRM做前缀，则以后增加任何程序代码，都需要以PRM这个作为前缀做项目的名称。2、项目名称必须使用英文描述，要求英文字母不超过12个字母，并且使用英文单词不可超过2个单词。还要要求命名词要达
12、意，一目了然。如果名称使用英文单词太多则可以把前面几个单词简写，即使用单词首个字母即可。但是必须达到词要达意的原则。2.16命名空间写代码定义的任何类，都必须包含在指定的命名空间内。根据不同类属性可以设置不同的命名空间。命名空间定义格式：公司名(英文).项目名前缀.项目名称.属性名称(自定义)，使用首字母大写样式。例如：我们把所有数据模型定义的类都放在这个命名空间下：Sivan.PRM.Data.Model其中：Sivan-公司英文名PRM-项目名前缀Data-项目名称Model-属性名称2.17大小写规范总结标识符大小写示例类/结构首字母大写样式AppDomain枚举类型首字母大写样式Err
13、orLevel枚举值首字母大写样式FatalError事件首字母大写样式ValueChange异常类首字母大写样式WebException 注意总是以 Exception 后缀结尾。只读的静态字段首字母大写样式RedValue接口首字母大写样式IDisposable 注意总是以 I 前缀开始。集合首字母大写样式CustomerCollection注意 总是以Collection结束方法首字母大写样式ToString命名空间首字母大写样式System.Drawing参数首字母小写样式typeName属性首字母大写样式BackColor受保护的实例字段首字母小写样式redValue 注意很少使用。
14、属性优于使用受保护的实例字段。公共实例字段首字母大写RedValue 注意很少使用。属性优于使用公共实例字段。第二部分 编码规范1.源文件尽量保持类文件的简短，最好不要超过2000行，每个类分别存放在单独的文件中2.目录结构每个命名空间对应一个目录. (例如命名空间GIS.MyMedia.Web.UI对应目录为GIS/MyMedia/Web/UI，这样可以方便的根据命名空间找到其相应的目录。3.排版3.1换行当代码一行写不下时，参考如下规则换行：1.在逗号后面换行.2.在操作符后面换行.3.对于表达式选用高级别处换行，而不要在低级别处换行4.新行表达式应该与上一行同一级别的该表达式对齐方法调用换行示例:longMethodCall(expr1, expr2,expr3, expr4, expr5);算术表达式换行示例:最佳风格:Var = a * b / (c - g + f) +4 * z;不良风格:var = a * b / (c - g +f) + 4 * z;第一个编码为最佳风格，因为其在
