MicroTeam 代码规范注意事项

        移山之道中说得好,写代码和打麻将不同,打麻将可以乱摆,让别人看不清自己牌路,但是代码不同,是需要人看的,一个统一的代码风格有助于提高大家理解代码的效率,增加代码的强壮性,下面是我建议的一个代码规范标准,希望大家在写team projecct的程序代码时可以遵守。(大部分参考《移山之道》)

         1.缩进  Tab 4个空格

     2.一个逻辑最好写一行,便于调试,例如: if (condition)   DoSomething();应该写成:

                   if (condition)

       {

          DoSomething();

                   }

         3.不要节省{}的使用,例如上例,虽然只有if中只有一句,但是请加上{}

         4.命名标准:

                (a)变量名:

                               对于局部变量:第一个字母小写,从第二个单词开始,每个单词的首字母大写。

                                        例如:int  myDocument;

                               对于全局变量(或者说类变量):以下划线开头,从第一个单词开始,每个单词第一个字母大写

                                        例如:int  _MyDocument;

                 (b) 属性名:

                              从第一个单词开始每个单词首字母大写,

                                        例如:  int  MyDocument

                  {

                    get;

                  }

                (c)函数名:

                             从第一个单词开始每个单词首字母大写,命名中最好包含动词。

                                        例如: public void PrintMyDocument();

                 (d) 类名:

                             从第一个单词开始每个单词首字母大写。

                 (e)接口名:

                             以I开头,后面的每个单词首字母大写。  

        5.函数与函数之间至少空一行,不要多过3行

        6.注释:

               只用来解释程序做什么,为什么这样做,以及要特别注意的地方做就行了。至于怎

               么做,应该由代码来解释。

        7.对于结构性较强的部分,可以用  #region  ,#endregion  加以括起来,同时加以

              注释,例如:

                            #region    selection  sort algorithm

                                  。

                                  。

                                  。

                            #endregion                

   

         好,今天就写这么多规范,如果有补充请尽快回复,谢谢您的支持!:),希望MicroTeam的队员们,如果参与代码的开发,请尽量遵守上面的规范。谢谢合作!O(^_^)O      

 

MicroTeam  Liuhang          

posted on 2010-12-24 11:43  MicroTeam  阅读(406)  评论(3编辑  收藏  举报