软件编程原则与编程规范.doc

软件设计原则编程规范 （仅供内部使用） 拟制： 审核： 审核： 批准：  修 订 记 录 前言 为了提高源程序的质量和可维护性，最终提高公司软件产品生产力，我们有必要对公司软件产品的源程序的编写风格作出统一的规范约束本的内容包括：排版、注释、、等。本的示例以C语言为背景Other(); for (initialization; condition; update) dosomething(); other(); 示例2-2(a) 风格良好的代码行 示例2-2(b) 风格不良的代码行 【建议2-2-1】尽可能在定义变量的同时初始化该变量（就近原则）。 如果变量的引用处和其定义处相隔比较远，变量的初始化很容易被忘记。例如： int width = 10; // 定义并初绐化width int height = 10; // 定义并初绐化height int depth = 10; // 定义并初绐化depth 2.3 代码行内的空格 【规则2-3-1】关键字之后要留空格。象const、virtual、inline、case 等关键字之后至少要留一个空格，否则无法辨析关键字。象if、for、while 等关键字之后应留一个空格再跟左括号‘（’，以突出关键字。 【规则2-3-2】函数名之后不要留空格，紧跟左括号‘（’，以与关键字区别。 【规则2-3-3】‘（’向后紧跟，‘）’、‘，’、‘;’向前紧跟，紧跟处不留空格。 【规则2-3-4】‘，’之后要留空格，如Function(x, y, z)。如果‘;’不是一行的结束符号，其后要留空格，如for (initialization; condition; update)。 【规则2-3-5】赋值操作符、比较操作符、算术操作符、逻辑操作符、位域操作符， 如“=”、“+=” “=”、“=”、“+”、“*”、“%”、“”、“||”、“”,“^”等二元操作符的前后应当加空格。 【规则2-3-6】一元操作符如“!”、“~”、“++”、“--”、“”（地址运算符）等前后不加空格。 【规则2-3-7】象“［］”、“.”、“-”这类操作符前后不加空格。 【建议2-3-1】对于表达式比较长的for 语句和if 语句，为了紧凑起见可以适当地去掉一些空格，如for (i=0; i10; i++)和if ((a=b) (c=d)) Void Func1(int x, int y, int z); // 良好的风格 void Func1 (int x,int y,int z); // 不良的风格 if (year = 2000) // 良好的风格 if(year=2000) // 不良的风格 if ((a=b) (c=d)) // 良好的风格 if(a=bc=d) // 不良的风格 for (i=0; i10; i++) // 良好的风格 for(i=0;i10;i++) // 不良的风格 for (i = 0; I 10; i ++) // 过多的空格 x = a b ? a : b; // 良好的风格 x=ab?a:b; // 不好的风格 int *x = y; // 良好的风格 int * x = y; // 不良的风格 array[5] = 0; // 不要写成array [ 5 ] = 0; a.Function(); // 不要写成a . Function(); b-Function(); // 不要写成b - Function(); 示例2-3 代码行内的空格 2.4 对齐 【规则2-4-1】程序的分界符‘{’和‘}’应独占一行并且位于同一列，同时与引用它们的语句左对齐。 【规则2-4-2】{ }之内的代码块在‘{’右边数格处左对齐。 示例2-4（a）为风格良好的对齐，示例2-4（b）为风格不良的对齐。 Void Function(int x) { … // program code } void Function(int x) { … // program code } if (condition) { // program code } else { // program code } if (condition) { // program code } else