1、农行：62284 8012 02154 66919田金沅1. 引言本文是一套面向 C# programmer 和 C# developer 进行开发所应遵循的开发规范。按照此规范来开发 C#程序可带来以下益处： 代码的编写保持一致性， 提高代码的可读性和可维护性， 在团队开发一个项目的情况下，程序员之间可代码共享 易于代码的回顾，本规范是初版，只适用于一般情况的通用规范，并不能覆盖所有的情况。2. 文件组织2.1 C# 源文件类名或文件名要简短，不要超过 2000LOC，将代码分割开，使结构清晰。将每个类放在一个单独的文件中，使用类名来命名文件名（当然扩展名是.cs）。这种约定会使大家工作更简
2、单。2.2 目录设计为每一个命名空间创建一个目录。（用 MyProject/TestSuite/TestTier作为 MyProject.TestSuite.TestTier的路径，而不用带点的命名空间名做路径）这样可以更容易地将命名空间映射到目录层次划分。 3. 缩进3.1 换行当一个表达式超过一行时，根据这些通用原则进行处理： 在逗号后换行。 在操作符后换行。 在高层换行而不要在低层处换行。 折行后对齐上一行语句同一层的表达式起始位置。方法调用换行示例： longMethodCall(expr1, expr2,expr3, expr4, expr5); 算术表达式换行示例： 推荐：var
3、= a * b / (c - g + f) +4 * z;不好的格式应避免：var = a * b / (c - g +f) + 4 * z; 推荐使用第一种方法，因为是在括号表达式之外折行（高层次折行原则）。注意要用制表符到缩进的位置，然后用用空格到折行的位置。在我们的例子中是： var = a * b / (c - g + f) + 4 * z;表示是制表符，.表示是空格符。（制表符后是空白是用制表符缩进）。一个好的编码习惯就是在所用的编辑器中显示制表符和空格符。3.2 空白利用空格进行缩进从未有过统一的标准。一些人喜欢用两个空格，一些人喜欢用四个空格而还有一些人喜欢用八个空格，甚至有的人
4、喜欢用更多的空格。好的做法是用制表符。制表符有一些优点： 每个人都可以设置他们自己喜欢的缩进层级。 它仅仅是 1 个字符而不是 2，4 ，8 等等，因此它将减少输入（甚至因为自动缩进，有时你不得不手工设置缩进或取消设置，等等诸如此类的操作）。 如果你想增加或减少缩进，可以标记一块，使用 Tab 增加缩进层级而用 Shift-Tab 减少缩进层级。这几乎对于任何文本编辑器都是适用的。这里，我们定义制表符为标准缩进符。不要用空格缩进用制表符！4. 注释4.1 块注释块注释通常应该是被避免的。推荐使用/注释作为 C#的标准声明。如果希望用块注释时你应该用以下风格：/* Line 1* Line 2*
5、 Line 3*/因为样可以为读者将注释块与代码块区分开。虽然并不提倡使用 C 风格的单行注释，但你仍然可以使用。一旦用这种方式，那么在注释行后应有断行，因为很难看清在同一行中前面有注释的代码：/* blah blah blah */块注释在极少情况下是有用的。通常块注释用于注释掉大的代码段。4.2 单行注释你应该用/注释风格“注释掉”代码（快捷键，Alt+/ ）。它也可以被用于代码的注释部分。单行注释被用于代码说明时必须缩进到相应的编进层级。注释掉的代码应该放在第一行被注释掉以使注释掉的代码更容易看清。一条经验，注释的长度不应该超过被解释代码的长度太长，因为这表示代码过于复杂，有潜在的 bu
6、g。4.3 文件注释在.net 框架，Microsoft 已经介绍了一个基于 XML 注释的文件。这些文件是包括 XML 标签的正规的单行的 C#注释。他们遵循单行注释的模式： / / This class./ 多行 XML 注释遵循这种模式： / / This exception gets thrown as soon as a/ Bogus flag gets set./ 为了被认作是 XML 注释行，所有的行都必须用三个反斜线开始。标签有以下两类： 文件说明项 格式/参考第一类包括像, or 的标签。描述一个程序的 API 元素的这些文档说明项必须写清楚以方便其他程序员。如上面的多行注释
7、示例所示，这些标签通常带有名称或 cref 属性。编译器会检查这些属性，所以它们必须是有效、正确的。第二类用诸如, or 标签，用于控制备注说明的布局。文件可以用文件菜单中的创建菜单产生。文件以 HTML 格式产生。5. 声明5.1 每行的声明数推荐每行只有一个声明，因为它可以方便注释。int level; / indentation levelint size; / size of table当声明变量时，不要把多个变量或不同类型的变量放在同一行，例如： int a, b; /What is a? What does b stand for?上面的例子也显示了变量名不明显的缺陷。当命名变量时
8、要清晰。5.2 初始化局部变量一旦被声明就要初始化。例如： string name = myObject.Name;或int val = time.Hours;注意：如果你初始化一个 dialog，设计使用 using 语句： using (OpenFileDialog openFileDialog = new OpenFileDialog() .5.3 类和接口声明当编写 C#类和接口时，应遵循以下格式化规则： 在方法名和圆括号“( ”开始它的参数列表之间不要使用空格。 在声明语句的下一行以大括号“ 标志开始。 以“结束，通过它自身的缩进与相应的开始标志匹配。例如： Class MySamp
9、le : MyClass, IMyInterfaceint myInt;public MySample(int myInt)this.myInt = myInt ;void Inc()+myInt;void EmptyMethod()对于一个大括号的位置参考 10.1 部分。6. 语句6.1 简单语句每行都应该只包含一条语句。6.2 返回语句一个返回语句不要用最外围圆括号。不用： return (n * (n + 1) / 2);用： return n * (n + 1) / 2;6.3 If, if-else, if else-if else 语句if, if-else and if els
10、e-if else 语句看起来应该像这样： if (condition) DoSomething();.if (condition) DoSomething();. else DoSomethingOther();.if (condition) DoSomething();. else if (condition) DoSomethingOther();. else DoSomethingOtherAgain();.6.4 for / foreach 语句一个 for 语句应该如下形式： for (int i = 0; i 5; +i) .或者放置一行（考虑用一个 while 语句代替）for
11、 (initialization; condition; update) ;foreach 语句应该像下面所示 :foreach (int i in IntList) .注意：在一个循环中，即使只有一个语句通常也用括弧括起来。6.5 While/do-while 语句一个 while 语句应该写成如下形式： while (condition) .一个空 while 语句应该是以下格式： while (condition) ;一个 do-while 语句应该是如下格式： do . while (condition);6.6 Switch 语句一个 switch 语句应该如下格式： switch
12、(condition) case A:.break;case B:.break;default:.break;6.7 Try-catch 语句一个 try-catch statement 语句应该遵循以下格式： try . catch (Exception) ortry . catch (Exception e) .ortry . catch (Exception e) . finally .7. 空白7.1 空行空行提高可读性。它们分开那些逻辑上自身相关联的代码块。两行空格行应该用于以下之间： 一个源文件的逻辑段。 类和接口定义（每个文件只定义一个类或接口以避免这种情况）。一个空格行应该总是
13、被用于以下之间： 方法 属性 一个方法中的局部变量和它的第一条语句 一个方法中的逻辑段为了提高可读性。注意空白行必须被缩进因为它们包括一条语句这使得插入这些行更容易。7.2 内部空格在一个逗号或一个分号之后应该由一个空格，例如： TestMethod(a, b, c); 不要用： TestMethod(a,b,c)或TestMethod( a, b, c );单个空格包围操作符（除了像加的一元操作符和逻辑非），例： a = b; / dont use a=b;for (int i = 0; i 10; +i) / dont use for (int i=0; i10; +i)/ or/ for
14、(int i=0;i10;+i)7.3 表格格式化行的一个逻辑块应该作为一个表格被格式化： string name = “Mr. Ed“;int myValue = 5;Test aTest = Test.TestYou;对于表格的格式化用空格而不用制表符因为在某些制表符缩进设置会使表格格式化看起来是很奇怪。8. 命名习惯8.1 大写格式8.1.1 Pascal Casing习惯大写每个单词的第一个字母（就像在 TestCounter）。8.1.2 Camel Casing习惯除了第一个单词外大写每个单词的第一个字母例如 testCounter。8.1.3 全大写情况对于只有一两个字符缩写组成
15、的标识符才用全大写的情况。有三个或更多个字符组成的标识符应该用 Pascal 情况代替。例如： public class Mathpublic const PI = .public const E = .public const feigenBaumNumber = .8.2. 命名指导方针通常根据指导方针在名字和命名内用低线字符对 Hungarian 符号来说被认为是坏习惯。Hungarian 符号是一组应用于命名来映射变量类型的前缀和后缀。这种命名风格在早期的 Windows 程序中被广泛应用，但现在被取消了至少不提倡了。如果你遵循这个指南用 Hungarian 符号是不允许的。但要记住一
16、个好的变量名描述了语义而不失类型。对于这个规则有个例外就是 GUI 编码。包括像按钮（buttton ）的 GUI 元素，所有领域和变量名都应该带有它们类型名的后缀不是缩写。例如：System.Windows.Forms.Button cancelButton;System.Windows.Forms.TextBox nameTextBox;8.2.1 类命名指导方针 类命名必须是名词或名词短语。 UsePascal 情况参考 8.1.1 不要用任何类前缀8.2.2 接口命名指导方针 Guidelines 用可以描述行为的名词或名词短语或形容词命名接口。（例如 IComponent 或 IEn
17、umberable） 用 Pascal 情况（参考 8.1.1） 用 I 作为名字的前缀，它应该紧跟一个大写字母（接口名的第一个字母）8.2.3 枚举命名指导方针 用 Pascal 情况命名枚举值名字和类型名字 枚举类型和枚举值不要前缀 对于枚举用单一名字 对于位领域用复数名字8.2.4 只读和常量命名 用名词，名词短语或名词的缩写命名静态领域 使用 Pascal 情况（参考 8.1.1）8.2.5 参数/非常量领域命名 一定要用描述性名字，应该能够足够表现变量的意义和它的类型。但一个好的名字应该基于参数的意义。 使用 Camel 情况（参考 8.1.2）8.2.6 变量命名 计数变量当用在琐
18、碎的计数循环式更适宜叫 i, j, k, l, m, n。（参考 10.2 例如对全局计数的更智能命名等等） 使用 Camel 情况（参考 8.1.2）8.2.7 方法命名 用动词或动词短语命名方法。 使用 Pascal（参考 8.1.2）8.2.8 属性命名 用名词或名词短语命名属性 使用 Pascal 情况（参考 8.1.2） 考虑用与其类型相同的名字命名一个属性8.2.9 事件命名 用事件处理器后缀命名事件处理器 用 sender 和 e 命名两个参数 使用 Pascal 情况（参考 8.1.1） 用 EventArgs 后缀命名事件参数 用现在和过去时态命名有前缀和复制概念的事件名字。
19、 考虑用一个动词命名事件。8.2.10 大写总结Type Case NotesClass / Struct Pascal Casing Interface Pascal Casing Starts with IEnum values Pascal Casing Enum type Pascal Casing Events Pascal Casing Exception class Pascal Casing End with Exceptionpublic Fields Pascal Casing Methods Pascal Casing Namespace Pascal Casing Pr
20、operty Pascal Casing Protected/private Fields Camel Casing Parameters Camel Casing 9. 编程习惯9.1 可见性不要任何公共实例或类变量，让它们为私有的。对于私有成员最好不用“private”作修饰语什么都不写。私有是默认情况，每个 C#程序员都应该知道这一点。用属性代替。你可以用公共静态（或常量）对于这个规则是以例外，带它不应该是规则。 9.2 没有“幻”数不要用幻数，也就是在源代码中直接用常数值。替代这些后者以防变化（比方说， 你的应用程序可以处理 3540用户代替 427你的代码在 50行中通过分散 250
21、00LOC）是错误和没有收益的。声明一个带有数的常量来代替： public class MyMathpublic const double PI = 3.14159.10. 编码举例10.1 Brace placement examplenamespace ShowMeTheBracketpublic enum Test TestMe,TestYoupublic class TestMeClassTest test;public Test Test get return test;set test = value;void DoSomething()if (test = Test.TestMe
22、) /.stuff gets done else /.other stuff gets done括弧应该在以下情况之后以新行开始： 命名空间声明（注意这在 0.3 版本中是新添的与 0.2 版本不同） 类/接口/结构声明 方法声明10.2 变量命名举例代替： for (int i = 1; i num; +i) meetsCriteriai = true;for (int i = 2; i num / 2; +i) int j = i + i;while (j = num) meetsCriteriaj = false;j += i;for (int i = 0; i num; +i) if
23、(meetsCriteriai) Console.WriteLine(i + “ meets criteria“);try intelligent naming :for (int primeCandidate = 1; primeCandidate num; +primeCandidate)isPrimeprimeCandidate = true;for (int factor = 2; factor num / 2; +factor) int factorableNumber = factor + factor;while (factorableNumber = num) isPrimef
24、actorableNumber = false;factorableNumber += factor;for (int primeCandidate = 0; primeCandidate num; +primeCandidate)if (isPrimeprimeCandidate) Console.WriteLine(primeCandidate + “ is prime.“);注意：索引变量通常叫 i, j, k 等等。但 Note: Indexer variables generally should be called i, j, k etc. But 万一像这样，使得重新考虑这个原则更有意义。一般来说，当同一个计数器或索引器被重用，给它们有意义的名字。
