实用的C语言编程规范.doc

--------------------------校验:_____________-----------------------日期:_____________实用的C语言编程规范实用的C语言编程规范目录简介 31代码编写总体原则 4清晰第一 4简洁为美 4选择合适的风格,与代码原有风格保持一致 42文件结构 5文件信息说明 5头文件的结构 5函数编写规则 63标示符的命名规则 84文件命名规则 95变量命名规则 106函数命名规则 107宏命名规则 108变量 109注释 1210排版与格式 1612参数设计规则 1713返回值的规则 18简介:在项目团队协作开发的情况下,编程时应该强调的一个重要方面是程序的易读性,在保证软件速度等性能指标能满足用户需求的情况下,能让其他程序员容易读懂你所编写的程序。若项目小组的所有开发人员都遵循统一的、鲜明的一套编程风格,可以让协作者、后继者和自己一目了然,在很短的时间内看清楚程序结构,理解设计的思路,大大提高代码的可读性、可重用性、程序健壮性、可移植性、可维护性,对彼此交流和协同开发将起到事半功倍的作用。制定本编程规范的目的是为了提高软件开发效率及所开发软件的可维护性,提高软件的质量。本规范由程序风格、命名规范、注释规范、可移植性以及软件的模块化规范等部分组成。用简单的方法去做复杂的事!!!1代码编写总体原则清晰第一清晰性是易于维护、易于重构的程序必须具备的特征。代码首先是给人读的,好的代码应该像好的文章一样发声朗读出来。目前软件维护期成本占整个软件生命周期成本的40%-90%。根据业界经验,维护期变更代码的成本,小型系统是开发期的5倍,大型系统(100万行代码以上)可以达到100倍。业界的调查指出,开发组平均大约一半的人力用于弥补过去的错误,而不是添加新的功能来帮助公司提高竞争力。一般情况下,代码的可阅读性高于性能,只有确定性能是瓶颈时,才应该主动优化。“程序必须为阅读它的人而编写,只是顺便用于机器执行。”――HaroldAbelson和GeraldJay“编写程序应该以人为本,计算机第二。”――onnell简洁为美简洁就是易于理解并且易于实现。代码越长越难于看懂,也越容易在修改时引入错误,写的代码越多,意味着出错的地方越多,也就意味着代码的可靠性越低。因此,我们提倡大家通过编写简洁明了的代码来提升代码可靠性。废弃的代码(没有被调用的函数和全局变量)要及时清除,重复代码应该尽可能提炼成函数。选择合适的风格,与代码原有风格保持一致产品所有人共同分享同一种风格所带来的好处,远远超出为了统一而付出的代价。在公司已有编码规范的指导下,审慎地编排代码以使代码尽可能清晰,是一项非常重要的技能。2文件结构每个C程序通常分为两个文件。一个文件用于保存程序的声明(declaration),称为头文件。另一个文件用于保存程序的实现(implementation),称为定义(definition)文件。C程序的头文件以“.h”为后缀,C程序的定义文件以“.c”为后缀。文件信息说明文件信息声明位于头文件和定义文件的开头(参见示例1),主要内容有:公司名称;文件名称;版权信息;当前版本,作者/修改者,完成日期;主要函数描述;注意事项;示例1头文件的结构头文件由三部分内容组成:头文件开头处的文件信息说明(参见示例1);预处理块;函数和类结构声明等。为了防止头文件被重复引用,应当用ifndef/define/endif结构产生预处理块;单词间以下划线“_”连接,例如有头文件名称为“”,则定义如下:“#ifndef _FILE_SYSTEM_H_”。用#include<格式来引用标准库的头文件(编译器将从标准库目录开始搜索)。用#include格式来引用非标准库的头文件(编译器将从用户的工作目录开始搜索)。头文件中只存放“声明”而不存放“定义”。头文件中应包含所有定义文件所定义的函数声明,如果一个头文件对应多个定义文件,则不同定义文件内实现的函数要分开声明,并作注释以解释所声明的函数从属于那一个定义文件。编写规则函数设计的精髓:编写整洁函数,同时把代码有效组织起来。整洁函数要求:代码简单直接、不隐藏设计者的意图、用干净利落的抽象和直截了当的控制语句将函数有机组织起来。一个函数仅完成一件功能。说明:一个函数实现多个功能给开发、使用、维护都带来很大的困难。将没有关联或者关联很弱的语句放到同一函数中,会导致函数职责不明确,代码混乱,难以理解,难以测试和改动。延伸阅读材料:《敏捷软件开发:原则、模式与实践》第八章,单一职责原则(SRP)。。说明:重复代码提炼成函数可以带来维护成本的降低。项目组应当使用代码重复度检查工具,在持续集成环境中持续检查代码重复度指标变化趋势,并对