程序代码编写规范

程序代码编写规范

一、命名规范

1.标识符的名字应当直观且可以拼读，可望文生义，不必进行“解码”。最好采用英文单

词或其组合，便于记忆和阅读。切忌使用汉语拼音来命名。程序中的英文单词一般不要太复杂，用词应当准确。

2.标识符的长度应当符合“min-length&max-information”原则。如果标识符采用的英文单

词太长，几个单词组合后会更长，此时应该采用一些通用而合理的缩写或者应用领域专业术语的缩写。例如：Program :<----> Pro Channel<---->CH Transponder<---->TP

3..程序中不要出现仅靠大小写来区分的相似标识符。

4.不要使程序中出现局部变量和全局变量同名的现象，尽管由于两者的作用域不同而不会

发生语法错误，但会使人误解。

5.变量的名字应当使用“名词”或者“形容词＋名词”的格式来命名。

例如：int ivalue; int ioldValue; int newValue;

6.全局函数的名字应当使用“动词”或者“动词＋名词”（动宾词组）。

7.用正确的反义词组命名具有相反意义的变量或相反动作的函数等。

例如：void SetValue(int iValue)

int GetValue(void)

8.尽量避免名字中出现数字编号，如Value1、Value2等，除非逻辑上的确需要如此。

9.类型名和函数名均以大写字母开头的单词组合而成。

10.变量名和参数名采用第一个单词首字母小写而后面的单词首字母大写的单词组合。

11.符号常量和宏名用全大写的单词组合而成，并在单词之间用单下划线分隔，注意首尾最

好不要使用下划线。

二、语句编写规范

12.函数变量都应该初始化。

13.虽然C语言支持默认类型为int，但都不要使用默认数据类型。一定要明确指出函数每

一个形参的类型和返回值类型。

14.在使用运算符&&的表达式中，要尽量把最有可能为false的子表达式放在&&的左边;同

样在使用运算符||的表达式中，要尽量把最有可能为TRUE的子表达式放在||的左边。因为C语言对逻辑表达式的判断采取“突然死亡法”（猝死法）：如果&&左边的子表达式计算结果为FALSE，则整个表达式就为FALSE，后面的子表达式没有必要再计算，如果||左边的子表达式计算结果为TRUE，则整个表达式就为TRUE，因此后面的子表达式没有必要再计算，这就可以提高程序的执行效率。

15.不要编写太复杂的复合表达式，应该拆分为多个独立的语句。

16.在if/else结构中，要尽量把为TRUE的概率较高的条件判断置于前面，这样可以提高该

段程序的性能。

17.switch没有自动跳出的功能，每个case子句的结尾不要忘了加上break，不要忘记最后

那个default子句。即使程序真的不需要default处理，也应该保留语句default:break;这样做并非多此一举，而是为了防止别人误以为你忘了default处理，以及出于清晰性和对称性的考虑。

18.对于for循环语句，如果计数器从0开始计数，则建议for语句的循环控制变量的取值采

用“前闭后开区间”写法，要防止出现“差1”错误。

例如：for(x = 0; x < N; x++)

{

}

不要写成

for(x = 0; x < = N - 1; x++)

{

}

19.在多重嵌套的循环中，如果有可能，应当将最长的循环放在最内层，最短的循环放在最

外层，这样可以减少CPU跨切循环层的次数，从而优化程序的性能。

20.如果循环体内存在逻辑判断，并且循环次数很大，宜将逻辑判断移到循环体的外面。

21.尽量使用含义直观的符号常量来表示那些将在程序中多次出现的数字或字符串。例如给

界面中用到的一些位置常量等。

22.需要对外公开的常量放在头文件中，不需要对外公开的常量放在定义文件的头部。为便

于管理，可以把不同模块的常量集中存放在一个公共的头文件中。如果某一常量与其他常量密切相关，应在定义中包含这种关系，而不应给出一个孤立的值。例如：

const float RADIUS = 100;

const float DIAMETER = RADIUS*2

三、函数编写规范

23.在你需要某种功能的函数时，首先查看现有的库中是否提供了类似的函数。不要编写函

数库中已有的函数，不仅因为这种是重复劳动，而且自制的函数在各个质量属性方面一般都不如对应的库函数。库函数是经过严格测试和实践检验的。

24.应当在函数原型中写出形参名称，虽然编译器会忽略它。这样做的目的是使函数具有“自

说明”和“自编档”能力。不要在函数体内定义与形参同名的局部变量，否则会遮蔽形参。

25.如果函数没有参数，那么使用void而不要空着，这是因为标准C把空的参数列表解释

为可以接受任何类型和个数的参数。

26.参数命名要恰当，输入参数和输出参数的顺序要合理。

例如：void StringCopy(char *str1, char *str2);

应改为

void StringCopy(char *strDestination, char *strSource);

27.如果参数是指针，且仅做输入用，则应在类型前加const，以防止该指针指向的内存单

元在函数体内被无意中修改。

28.应避免函数有太多的参数，参数个数尽量控制在5个以内。如果参数太多，在使用时容

易将参数糊弄和顺序搞错。

29.尽量不要使用类型和数目不确定的参数列表。这种风格的函数在编译时丧失了严格的静

态类型安全检查。

30.不要省略返回值的类型。如果函数没有返回值，应声明为VOID类型。

31.函数名字与返回值类型在语义上不可冲突。