软件开发代码规范(C语言).doc

软件开发代码规范 (仅供内部使用) 拟制： 日期： 201-3-11 审核： 日期： 核准： 日期： 签发： 日期： 文档版本：V0.1 黑龙江通普信息技术股份有限公司  目录 第一章 原则 5 第二章 排版 6 2.1 空行 6 2.2 代码行 7 2.3 代码行内的空格 7 2.4 对齐缩进 8 2.5 长行拆分 9 第三章 注释 11 3.1 通用规则 11 3.2 文件注释 11 3.3 函数注释 12 3.4 数据注释 13 3.5 代码注释 13 第四章 命名 16 4.1 通用命名规则 16 4.2 文件命名 16 4.3 类型命名 16 4.4 变量命名 17 4.5 常量命名 18 4.6 函数命名 18 4.7 枚举命名 18 4.8 宏命名 18 第五章 杂项 20 第一章 原则 本文档的目的是提供一个公共的编码规范。 这个规范详细阐述在编码时要怎样写、不要怎样写，旨在提高代码的可读性、可维护性，使代码易于管理，使所有人可以集中精力去实现内容，而非处理各种复杂的表现形式。 使代码易于管理的方法之一是增强代码一致性，让别人可以读懂你的代码是很重要的，保持统一编程风格意味着可以轻松根据“模式匹配”规则推断各种符号的含义。创建通用的、必需的习惯用语和模式可以使代码更加容易理解。虽然在某些情况下改变一些编程风格可能会是好的选择，但我们还是应该遵循一致性原则，尽量不这样去做。 关键在于保持一致。 第二章 排版 空行 【规则2-1-1】在每个函数、结构体、枚举定义结束之后都要加空行。 【规则2-1-2】在一个函数体内，逻辑密切相关的语句之间不加空行，其它地方应加空行分隔。 struct st1 { … }; // 空行 enum { … }; // 空行 void Function1(…) { … } // 空行 void Function2(…) { … } // 空行 while (condition) { statement1; // 空行 if (condition) { statement2; } else { statement3; } // 空行 statement4; } 函数之间的空行 函数内部的空行 【规则2-1-3】相对独立的程序块之间、变量说明之后必须加空行。 if (!is_lock_card_succ) { ... // program code } GetLockPhoneInfo(st_lock_phone_info); if (!is_lock_card_succ) { ... // program code } //空格 GetLockPhoneInfo(st_lock_phone_info); 不规范代码 规范代码 代码行 【规则2-2-1】一行代码只做一件事情，如只定义一个变量，或只写一条语句。这样的代码容易阅读，并且方便于写注释。 【规则2-2-2】if、for、while、do等语句自占一行，执行语句不得紧跟其后。不论执行语句有多少都要加{}。这样可以防止书写失误。 int width, height, depth;// 宽度高度深度 int width; // 宽度 int height; // 高度 int depth; // 深度 X ＝ a + b; y = c + d; z = e + f; x = a + b; y = c + d; z = e + f; if (width height) dosomething(); if (width height) { dosomething(); } for (initialization; condition; update) dosomething(); other(); for (initialization; condition; update) { dosomething(); } // 空行 other(); 不规范代码 规范代码 代码行内的空格 说明：空格的目的在于更清晰的代码。 【规则2-3-1】关键字之后要留空格。const、static等关键字之后至少要留一个空格，否则无法辨析关键字；if、for、while、switch等关键字之后应留一个空格再跟左括号‘(’，以突出关键字。 【规则2-3-2】函数名之后不要留空格，紧跟左括号‘(’，以与