软件编程规范

在当前软件行业迅猛的发展下，软件逐渐走向大型化。在这种软件走向大型化的形势下，一个软件需要众多的人参与。比如一个操作系统的开发需要上千人的工作。这样我们就不得不面临着如何管理。

只要是一个有用的软件就需要大量的工作，首先要进行 软件需求分析，然后要设计出软件的框架，而实现软件的代码仅占很少一部分（约20%）。而你不要小看这代码的实现，也是要很多人的参与的，一般 软件代码就有上千行，更别说操作系统了，据说Linux就有千万行的代码。这就需要把一个软件分成很多小的模块，分工完成。

编程规范概要

编辑

1、 程序结构清晰，简单易懂，单个函数的程序行数不得超过100行。

2、 打算干什么，要简单，直截了当，代码精简，避免垃圾程序。

3、 尽量使用标准 库函数和公共函数。

4、 不要随意定义 全局变量，尽量使用 局部变量。

5、 使用括号以避免二义性。

可读性要求

编辑

1、可读性第一，效率第二。

2、保持注释与代码完全一致。

3、每个 源程序文件，都有 文件头说明，说明规格见规范。

4、每个函数，都有 函数头说明，说明规格见规范。

5、主要 变量（结构、联合、类或对象）定义或引用时，注释能反映其含义。

6、 常量定义（DEFINE）有相应说明。

7、处理过程的每个阶段都有相关注释说明。

8、在典型算法前都有注释。

9、利用缩进来显示程序的 逻辑结构，缩进量一致并以Tab键为单位，定义Tab为 6个

字节。

10、循环、分支层次不要超过五层。

11、注释可以与语句在同一行，也可以在上行。

12、空行和空白字符也是一种特殊注释。

13、一目了然的语句不加注释。

14、注释的作用范围可以为：定义、引用、条件分支以及一段代码。

15、注释行数（不包括程序头和 函数头说明部份）应占总行数的 1/5 到 1/3 。

转自百度百科：https://baike.baidu.com/item/%E8%BD%AF%E4%BB%B6%E7%BC%96%E7%A8%8B%E8%A7%84%E8%8C%83/3263569#2