C#编码标准
1.利用Pascal的方式定义类型、方法名和常量
{
const int DefaultSize = 100;
public SomeMethod()
{
}
}
void MyMethod(int someNumber)
{}
{
![](https://www.cnblogs.com/Images/dot.gif)
{
private int m_Number;
}
6. 对自定义的异常类加上后缀Exception
7. 方法的命名使用动词——对象对。例如ShowDialog()
8. 有返回值的方法的命名中要有对返回值的描述。例如GetObjectState()
9. 使用带有说明性的变量名
a)避免单字符的变量名。例如i或t。使用类似于index或temp这样有意义的名字。
b)对于public或protected类型的变量避免使用匈牙利表示法
c)不要所写单词(例如用num取代number)
10. 总是使用c#预定义的类型而不是使用在System命名空间中的别名。例如:
使用object而不是Object
使用string 而不是String
使用int而不是Int32
11. 在使用泛型的时候,类型的首字母要大写。当处理.NET中的Type类型的时候,保留Type后缀。
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](https://www.cnblogs.com/Images/dot.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](https://www.cnblogs.com/Images/dot.gif)
13. 避免通过全限定方式使用类型名称,使用using关键字。
14. 避免在一个命名空间中使用using关键字
15. 把所有系统框架提供的命名空间组织到一起,把第三方提供的命名空间放到系统命名空间的下面
16. 使用代理推导而不要显示的实例化一个代理
17. 维护严格的代码缩进。不要使用tabs或非标准的缩进,例如一个空格。推荐的缩进市3到4个空格。
18. 在和你的代码缩进处于同一个级别处为该代码添加注释
19. 所有的注释都应该通过拼写检查。注释中的错误拼写意味着开发进度的延缓
20. 所有类成员变量应该被声明在类的顶部,并用一个空行把他们和方法以及属性的声明区分开
21. 在最靠近一个局部变量被使用的地方声明该局部变量
22. 一个文件名应该能够反映它所对应的类名
23. 当使用一个部分类并把该类分布到不同的文件中时,在每一个文件名末尾都加上该文件实现的部分在类整体中扮演的作用。
24. 总是要把“{”放在新的一行。
编码实践
1. 避免在同一个文件中放置多个类
2. 一个文件应该只向在一个命名空间内定义类型。避免在一个文件中使用多个命名空间
3. 避免在一个文件内些多余500行的代码
4. 避免写超过25行代码的方法
5. 避免写超过5个参数的方法。如果要传递多个参数,使用结构
6. 一行不要超过80字符
7. 不要手动去修改任何机器生成的代码
a)如果修改了机器生成的代码,修改你的编码方式来死适应这个编码标准
b)尽可能使用partial classes特性,以提高可维护性
8. 避免对那些直观的内容作注释。代码本身应该能够解释其自身的含义。由可读的变量名和方法名构成的优质代码应该不需要注释。
9. 注释应该只说明操作的一些前提假设、算法的内部信息等内容。
10. 避免对方法进行注释
a)使用充足的外部文档对API进行说明
b)只有对那些其他开发者的提示信息才有必要放到方法级的注释中来
11. 除了0和1,绝对不要对数值进行硬编码,通过声明一个常量来代替该数值
12. 只对那些亘古不变的数值使用const关键字,例如一周的天数
13. 避免对只读(read-only)的变量使用const关键字。
14. 对每一个假设进行断言。平均起来,每5行应有一个断言。
15. 每一行代码都应该以白盒测试的方式进行审读。
16. 只捕捉那些你自己能够显示处理的异常
17. 如果在catch语句块中需要抛出异常,则只抛出该catch所捕捉到的异常(或基于该异常而创建的其他异常),这样可以维护原始错误所在的堆栈位置。
{
MessageBox.Show(exception.Message);
throw;//或throw exception;
}
19. 避免自定义异常类
20. 当自定义异常类的时候
a)让你自定义的异常类从Exception类继承
b)提供自定义的串行化机制
21. 避免在一个程序集中定义多个Main()方法
22. 只把那些绝对需要的方法定义成public,而其他的方法定义成internal
23. 避免friend assermblies,因为这回增加程序集之间的耦合性
24. 避免让你的代码依赖于运行在某个特定地方的程序集
25. 在application assembly中最小化代码量。使用类库来包含业务逻辑
26. 避免显示指定枚举的值
public enum Color
{
Red,Green,Blue
}
//错误
public enum Color
{
Red=1,Green=2,Blue=3
}
public enum Color:long
{
Red,Green,Blue
}
29. 避免使用三元条件操作符
30. 避免利用函数返回的Boolean值作为条件语句。把返回值赋给一个局部变量,然后再检测
31. 总是使用以零为基数的数组
32. 总是使用一个for循环显示的初始化一个引用成员的数组
33. 使用属性来替代public或protected类型的成员变量
34. 不要使用继承下来的new操作符,使用override关键字覆写new的实现
35. 在一个非密封(non-sealed)类中,总是把那些public和protected的方法定义为virtual
36. 除非为了和其他语音进行互动,否则绝对不要使用不安全的代码
37. 避免显示类型转换。使用as关键字安全的转换到另一个类型
GermanShepherd shepherd = dog as GermanShepherd;
if(shepherd != null)
{
![](https://www.cnblogs.com/Images/dot.gif)
39. 不要提供public的事件成员变量。改用Event Accessor
40. 总是使用接口
41. 接口和类中方法和属性的比应该在2:1左右
42. 避免只有一个成员的接口
43. 努力保证一个接口有3~5个成员
44. 不要让一个接口中成员的数量超过20,而12则是更为实际的限制。
45. 避免在接口中包含事件
46. 当使用抽象类的时候,提供一个接口
47. 在类继承结构中暴露接口
48. 推荐使用显示接口实现
49. 从来不要假设一个类型支持某个接口。在使用前总是要询问一下。
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockEnd.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockEnd.gif)
50.不要硬编码向用户显示的字符串。要使用资源
51. 不要硬编码那些可能会随发布环境变化而变化的字符串,例如数据库连接字符串
52. 使用String.Empty取代""
53. 使用一个长字符串的时候,使用StringBuilder代替string
54. 避免在结构中提供方法a)参数化的构造函数是鼓励使用的b)可以重载运算符
55. 当声明了静态成员的时候,总是要提供一个静态构造函数
56. 当早绑定可能的时候就尽量不要使用迟绑定
57. 让你的应用程序支持跟踪和日志
58. 除了要在switch语句中实现代码跳转,不要使用goto关键字
59. 总在switch语句的default情形提供一个断言
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/None.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/InBlock.gif)
![](https://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockEnd.gif)
60. 除了在一个构造函数中调用其他的构造函数之外,不要使用this关键字
61. 不要使用base访问基类的成员,除非你在调用一个基类构造函数的时候要决议一个子类的名称冲突
62. 总是要在unchecked状态下运行代码,但是为了防止溢出或下溢操作,要果断使用checked模式
项目设置和项目结构
1. 总是在4级警告上建立你的项目
2. 在发布版中,把警告当成错误来对待
3. 避免关闭编译器的某些警告选项
4. 总是要在应用程序的配置文件中显示指定支持的运行时版本
5. 避免显示进行CLR程序集版本的重定向和绑定
6. 避免显示的预处理定义(#define)。使用项目设置来定义条件编译常量
7. 不要在AssemblyInfo.cs中加入任何逻辑
8. 不要在AssemblyInfo.cs之外的文件中添加程序级属性。
9. 提供AssemblyInfo.cs中的所有信息,例如公司名、描述和版权事项等
10. 同一个解决方案中的程序集引用都应该使用相同路径
11. 禁止在程序集之间使用循环引用
12. 避免多模块程序集
13. 避免利用异常窗口削弱异常处理
14. 坚持在同一个解决方案中的所有程序集之间使用统一的版本号
15. 把所有解决方案的信息存放到一个共享的SolutionInfo.cs文件中
16. 把你的应用程序的配置文件命名为App.config,并把它包含在你的项目中
17. 修改Visual Studio 2005 的默认项目结构来适应你的项目规划,并且对项目文件夹和文件使用统一的结构
18. 一个Release发布应该包含调试信息
19. 总是对你的程序集进行签名,包括你的客户应用程序