团队项目开发"编码规范"之四：申明

团队项目开发"编码规范"之四：申明 

发布日期：2011年3月18日星期三作者:EricHu

  勤能补拙、笨鸟先飞。

 

 

4.1 每行声明数

一行只作一个声明,如

 

          int level;   //推荐

          int size;    //推荐

          int x, y;    //不推荐

 

4.2 初始化

      建议在变量声明时就对其做初始化。       

 

4.3 位置

      变量建议置于块的开始处，不要总是在第一次使用它们的地方做声明。如

 

         void MyMethod()

          {

              int int1 = 0;         // beginning of method block

 

if (condition)

{

                  int int2 = 0;     // beginning of "if" block

                  ...

              }

          }

 

        不过也有一个例外

       

                for (int i = 0; i < maxLoops; i++)

                {

                    ...

                }

 

        应避免不同层次间的变量重名，如

 

            int count;

            ...

void MyMethod()

{

                if (condition)

                {

                    int count = 0;     // 避免

                     ...

                 }

                 ...

}

 

4.4 类和接口的声明

      1 在方法名与其后的左括号间没有任何空格。

      2 左花括号 “{” 出现在声明的下行并与之对齐，单独成行。

      3 方法间用一个空行隔开。

    

4.5 字段的声明

不要使用是 public 或 protected 的实例字段。如果避免将字段直接公开给开发人员，可以更轻松地对类进行版本控制，原因是在维护二进制兼容性时字段不能被更改为属性。考虑为字段提供 get 和set 属性访问器，而不是使它们成为公共的。 get 和 set 属性访问器中可执行代码的存在使得可以进行后续改进，如在使用属性或者得到属性更改通知时根据需要创建对象。下面的代码示例阐释带有get 和 set 属性访问器的私有实例字段的正确使用。 示例：

            public class Control: Component

            {

               private int handle;

               public  int Handle

               {

                  get

                  {

                     return handle;

                  }

               }

}

 

------------------------------------------------

cnBlobs:http://www.cnblogs.com/huyong/
CSDN： http://blog.csdn.net/chinahuyong