华为
c/c++
1. 排版
1-1:程序块要采用缩进风格编写,缩进的空格数为4个。
1-2:相对独立的程序块之间、变量说明之后必须加空行。
1-3:较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。
1-4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。
1-5:若函数或过程中的参数较长,则要进行适当的划分。
1-6:不允许把多个短语句写在一行中,即一行只写一条语句。
1-7:if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。
1-8:对齐只使用空格键,不使用TAB键。
1-9:函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格,case语句下的情况处理语句也要遵从语句缩进要求。
1-10:程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。
1-11:在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如->),后不应加空格。
2. 注释
2-1:一般情况下,源程序有效注释量必须在20%以上。
2-2:说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等,头文件的注释中还应有函数功能简要说明。
2-3:源文件头部应进行注释,列出:版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。
2-4:函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调用关系(函数、表)等。
2-5:边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。不再有用的注释要删除。
2-6:注释的内容要清楚、明了,含义准确,防止注释二义性。
2-7:避免在注释中使用缩写,特别是非常用缩写。
2-8:注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置,不可放在下面,如放于上方则需与其上面的代码用空行隔开。
2-9:对于所有有物理含义的变量、常量,如果其命名不是充分自注释的,在声明时都必须加以注释,说明其物理含义。变量、常量、宏的注释应放在其上方相邻位置或右方。
2-10:数据结构声明(包括数组、结构、类、枚举等),如果其命名不是充分自注释的,必须加以注释。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释放在此域的右方。
2-11:全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。
2-12:注释与所描述内容进行同样的缩排 。
2-13:将注释与其上面的代码用空行隔开。
2-14:对变量的定义和分支语句(条件分支、循环语句等)必须编写注释。
2-15:对于switch语句下的case语句,如果因为特殊情况需要处理完一个case后进入下一个case处理,必须在该case语句处理完、下一个case语句前加上明确的注释。
2-16:避免在一行代码或表达式的中间插入注释。
2-17:通过对函数或过程、变量、结构等正确的命名以及合理地组织代码的结构,
使代码成为自注释的。
2-18:在代码的功能、意图层次上进行注释,提供有用、额外的信息。
2-19:在程序块的结束行右方加注释标记,以表明某程序块的结束。
2-20:注释格式尽量统一,建议使用“/* „„ */”。
2-21:注释应考虑程序易读及外观排版的因素,使用的语言若是中、英兼有的,建议多使用中文,除非能用非常流利准确的英文表达。
3 标识符命名
3-1:标识符的命名要清晰、明了,有明确含义,同时使用完整的单词或大家基本可以理解的缩写,避免使人产生误解。
3-2:命名中若使用特殊约定或缩写,则要有注释说明。
3-3:自己特有的命名风格,要自始至终保持一致,不可来回变化。
3-4:对于变量命名,禁止取单个字符(如i、j、k...),建议除了要有具体含义外,还能表明其变量类型、数据类型等,但i、j、k作局部循环变量是允许的。
3-5:命名规范必须与所使用的系统风格保持一致,并在同一项目中统一,比如采用UNIX的全小写加下划线的风格或大小写混排的方式,不要使用大小写与下划线混排的方式,用作特殊标识如标识成员变量或全局变量的m_和g_,其后加上大小写混排的方式是允许的。
3-6:除非必要,不要用数字或较奇怪的字符来定义标识符。
3-7:在同一软件产品内,应规划好接口部分标识符(变量、结构、函数及常量)
的命名,防止编译、链接时产生冲突。
3-8:用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。
3-9:除了编译开关/头文件等特殊应用,应避免使用_EXAMPLE_TEST_之类以下
划线开始和结尾的定义。
4 可读性
4-1:注意运算符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级。
4-2:避免使用不易理解的数字,用有意义的标识来替代。涉及物理状态或者含有物理意义的常量,不应直接使用数字,必须用有意义的枚举或宏来代替。
4-3:源程序中关系较为紧密的代码应尽可能相邻。
4-4:不要使用难懂的技巧性很高的语句,除非很有必要时。
5 变量、结构
5-1:去掉没必要的公共变量。
5-2:仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。5-3:明确公共变量与操作此公共变量的函数或过程的关系,如访问、修改及创建等。
5-4:当向公共变量传递数据时,要十分小心,防止赋与不合理的值或越界等现象发生。
5-5:防止局部变量与公共变量同名。
5-6:严禁使用未经初始化的变量作为右值。
5-7:构造仅有一个模块或函数可以修改、创建,而其余有关模块或函数只访问的
公共变量,防止多个不同模块或函数都可以修改、创建同一公共变量的现象。
5-8:使用严格形式定义的、可移植的数据类型,尽量不要使用与具体硬件或软件环境关系密切的变量。
5-9:结构的功能要单一,是针对一种事务的抽象。
5-10:不要设计面面俱到、非常灵活的数据结构。5-5:不同结构间的关系不要过于复杂。
5-11:结构中元素的个数应适中。若结构中元素个数过多可考虑依据某种原则把元素组成不同的子结构,以减少原结构中元素的个数。
5-12:仔细设计结构中元素的布局与排列顺序,使结构容易理解、节省占用空间,
并减少引起误用现象。
5-13:结构的设计要尽量考虑向前兼容和以后的版本升级,并为某些未来可能的应用保留余地(如预留一些空间等)。
5-14:留心具体语言及编译器处理不同数据类型的原则及有关细节。
5-15:编程时,要注意数据类型的强制转换。
5-16:对编译系统默认的数据类型转换,也要有充分的认识。
5-17:尽量减少没有必要的数据类型默认转换与强制转换。
5-18:合理地设计数据并使用自定义数据类型,避免数据间进行不必要的类型转
换。
5-19:对自定义数据类型进行恰当命名,使它成为自描述性的,以提高代码可读
性。注意其命名方式在同一产品中的统一。
5-20:当声明用于分布式环境或不同CPU间通信环境的数据结构时,必须考虑机
器的字节顺序、使用的位域及字节对齐等问题。
6 函数、过程
6-1:对所调用函数的错误返回码要仔细、全面地处理。
6-2:明确函数功能,精确(而不是近似)地实现函数设计。
6-3:编写可重入函数时,应注意局部变量的使用(如编写C/C++语言的可重入函数时,应使用auto即缺省态局部变量或寄存器变量)。
6-4:编写可重入函数时,若使用全局变量,则应通过关中断、信号量(即P、V操作)等手段对其加以保护。
6-5:在同一项目组应明确规定对接口函数参数的合法性检查应由函数的调用者负责还是由接口函数本身负责,缺省是由函数调用者负责。
6-1:防止将函数的参数作为工作变量。
6-2:函数的规模尽量限制在200行以内。
6-3:一个函数仅完成一件功能。
6-4:为简单功能编写函数。
6-5:不要设计多用途面面俱到的函数。
6-6:函数的功能应该是可以预测的,也就是只要输入数据相同就应产生同样的输出。
6-7:尽量不要编写依赖于其他函数内部实现的函数。
6-8:避免设计多参数函数,不使用的参数从接口中去掉。
6-9:非调度函数应减少或防止控制参数,尽量只使用数据参数。
6-10:检查函数所有参数输入的有效性。
6-11:检查函数所有非参数输入的有效性,如数据文件、公共变量等。
说明:函数的输入主要有两种:一种是参数输入;另一种是全局变量、数据文件的输入,即非参数输入。函数在使用输入之前,应进行必要的检查。
6-12:函数名应准确描述函数的功能。
6-13:使用动宾词组为执行某操作的函数命名。如果是OOP方法,可以只有动词(名词是对象本身)。
6-14:避免使用无意义或含义不清的动词为函数命名。
6-15:函数的返回值要清楚、明了,让使用者不容易忽视错误情况。
6-16:除非必要,最好不要把与函数返回值类型不同的变量,以编译系统默认的
转换方式或强制的转换方式作为返回值返回。
6-17:让函数在调用点显得易懂、容易理解。
6-18:在调用函数填写参数时,应尽量减少没有必要的默认数据类型转换或强制
数据类型转换。
6-19:避免函数中不必要语句,防止程序中的垃圾代码。
6-20:防止把没有关联的语句放到一个函数中。
6-21:如果多段代码重复做同一件事情,那么在函数的划分上可能存在问题。
6-22:功能不明确较小的函数,特别是仅有一个上级函数调用它时,应考虑把它
合并到上级函数中,而不必单独存在。
6-23:设计高扇入、合理扇出(小于7)的函数。
6-24:减少函数本身或函数间的递归调用。
6-25:仔细分析模块的功能及性能需求,并进一步细分,同时若有必要画出有关
数据流图,据此来进行模块的函数划分与组织。
6-26:改进模块中函数的结构,降低函数间的耦合度,并提高函数的独立性以及
代码可读性、效率和可维护性。优化函数结构时,要遵守以下原则:
(1)不能影响模块功能的实现。
(2)仔细考查模块或函数出错处理及模块的性能要求并进行完善。
(3)通过分解或合并函数来改进软件结构。
(4)考查函数的规模,过大的要进行分解。
6-27:在多任务操作系统的环境下编程,要注意函数可重入性的构造。
6-28:避免使用BOOL参数。
6-29: 对于提供了返回值的函数,在引用时最好使用其返回值。
6-30:当一个过程(函数)中对较长变量(一般是结构的成员)有较多引用时,
可以用一个意义相当的宏代替。
7 可测性
7-1:在同一项目组或产品组内,要有一套统一的为集成测试与系统联调准备的调测开关及相应打印函数,并且要有详细的说明。
7-2:在同一项目组或产品组内,调测打印出的信息串的格式要有统一的形式。信息串中至少要有所在模块名(或源文件名)及行号。
7-3:编程的同时要为单元测试选择恰当的测试点,并仔细构造测试代码、测试用例,同时给出明确的注释说明。测试代码部分应作为(模块中的)一个子模块,以方便测试代码在模块中的安装与拆卸(通过调测开关)。
7-4:在进行集成测试/系统联调之前,要构造好测试环境、测试项目及测试用例,同时仔细分析并优化测试用例,以提高测试效率。
7-5:使用断言来发现软件问题,提高代码可测性。
7-6:用断言来检查程序正常运行时不应发生但在调测时有可能发生的非法情况。
7-7:不能用断言来检查最终产品肯定会出现且必须处理的错误情况。
7-8:对较复杂的断言加上明确的注释
7-9:用断言确认函数的参数。
7-10:用断言保证没有定义的特性或功能不被使用。
7-11:用断言对程序开发环境(OS/Compiler/Hardware)的假设进行检查。
7-12:正式软件产品中应把断言及其它调测代码去掉(即把有关的调测开关关掉)。
7-13:在软件系统中设置与取消有关测试手段,不能对软件实现的功能等产生影响。
7-14:用调测开关来切换软件的DEBUG版和正式版,而不要同时存在正式版本和DEBUG版本的不同源文件,以减少维护的难度。
7-15:软件的DEBUG版本和发行版本应该统一维护,不允许分家,并且要时刻注意保证两个版本在实现功能上的一致性。
7-16:在编写代码之前,应预先设计好程序调试与测试的方法和手段,并设计好各种调测开关及相应测试代码如打印函数等。
7-17:调测开关应分为不同级别和类型。
7-18:编写防错程序,然后在处理错误之后可用断言宣布发生错误。
8 程序效率
8-1:编程时要经常注意代码的效率。
8-2:在保证软件系统的正确性、稳定性、可读性及可测性的前提下,提高代码效率。
8-3:局部效率应为全局效率服务,不能因为提高局部效率而对全局效率造成影响。
8-4:通过对系统数据结构的划分与组织的改进,以及对程序算法的优化来提高空间效率。
8-5:循环体内工作量最小化。
8-6:仔细分析有关算法,并进行优化。
8-7:仔细考查、分析系统及模块处理输入(如事务、消息等)的方式,并加以改进。
8-8:对模块中函数的划分及组织方式进行分析、优化,改进模块中函数的组织结构,提高程序效率。
8-9:编程时,要随时留心代码效率;优化代码时,要考虑周全。
8-10:不应花过多的时间拼命地提高调用不很频繁的函数代码效率。
8-11:要仔细地构造或直接用汇编编写调用频繁或性能要求极高的函数。
8-12:在保证程序质量的前提下,通过压缩代码量、去掉不必要代码以及减少不必要的局部和全局变量,来提高空间效率。
8-13:在多重循环中,应将最忙的循环放在最内层。
8-14:尽量减少循环嵌套层次。
8-15:避免循环体内含判断语句,应将循环语句置于判断语句的代码块之中。
8-16:尽量用乘法或其它方法代替除法,特别是浮点运算中的除法。
8-17:不要一味追求紧凑的代码。
9 质量保证
9-1:在软件设计过程中构筑软件质量。
9-2:代码质量保证优先原则。
9-3:只引用属于自己的存贮空间。
9-4:防止引用已经释放的内存空间。
9-5:过程/函数中分配的内存,在过程/函数退出之前要释放。
9-6:过程/函数中申请的(为打开文件而使用的)文件句柄,在过程/函数退出之前要关闭。
9-7:防止内存操作越界。
9-8:认真处理程序所能遇到的各种出错情况。
9-9:系统运行之初,要初始化有关变量及运行环境,防止未经初始化的变量被引用。
9-10:系统运行之初,要对加载到系统中的数据进行一致性检查。
9-11:严禁随意更改其它模块或系统的有关设置和配置。
9-12:不能随意改变与其它模块的接口。
9-13:充分了解系统的接口之后,再使用系统提供的功能。
9-14:编程时,要防止差1错误。
9-15:要时刻注意易混淆的操作符。当编完程序后,应从头至尾检查一遍这些操作符,以防止拼写错误。
9-16:有可能的话,if语句尽量加上else分支,对没有else分支的语句要小心对待;switch语句必须有default分支。
9-17:Unix下,多线程的中的子线程退出必需采用主动退出方式,即子线程应return出口。
9-18:不要滥用goto语句。
9-19:不使用与硬件或操作系统关系很大的语句,而使用建议的标准语句,以提高
软件的可移植性和可重用性。
9-20:除非为了满足特殊需求,避免使用嵌入式汇编。
9-21:精心地构造、划分子模块,并按“接口”部分及“内核”部分合理地组织子模块,以提高“内核”部分的可移植性和可重用性。
9-22:精心构造算法,并对其性能、效率进行测试。
9-23:对较关键的算法最好使用其它算法来确认。
9-24:时刻注意表达式是否会上溢、下溢。
9-25:使用变量时要注意其边界值的情况。
9-26:留心程序机器码大小(如指令空间大小、数据空间大小、堆栈空间大小等)
是否超出系统有关限制。
9-27:为用户提供良好的接口界面,使用户能较充分地了解系统内部运行状态及有关系统出错情况。
9-28:系统应具有一定的容错能力,对一些错误事件(如用户误操作等)能进行
自动补救。
9-29:对一些具有危险性的操作代码(如写硬盘、删数据等)要仔细考虑,防止
对数据、硬件等的安全构成危害,以提高系统的安全性。
9-30:使用第三方提供的软件开发工具包或控件时,要注意以下几点:
(1)充分了解应用接口、使用环境及使用时注意事项。
(2)不能过分相信其正确性。
(3)除非必要,不要使用不熟悉的第三方工具包与控件。
9-31:资源文件(多语言版本支持),如果资源是对语言敏感的,应让该资源与
源代码文件脱离,具体方法有下面几种:使用单独的资源文件、DLL文件或其它单独的描述文件(如数据库格式)
10 代码编辑、编译、审查
10-1:打开编译器的所有告警开关对程序进行编译。
10-2:在产品软件(项目组)中,要统一编译开关选项。
10-3:通过代码走读及审查方式对代码进行检查。
10-4:测试部测试产品之前,应对代码进行抽查及评审。
10-5:编写代码时要注意随时保存,并定期备份,防止由于断电、硬盘损坏等原
因造成代码丢失。
10-6:同产品软件(项目组)内,最好使用相同的编辑器,并使用相同的设置选
项。
10-7:要小心地使用编辑器提供的块拷贝功能编程。
10-8:合理地设计软件系统目录,方便开发人员使用。
10-9:某些语句经编译后产生告警,但如果你认为它是正确的,那么应通过某种
手段去掉告警信息。
10-10:使用代码检查工具(如C语言用PC-Lint)对源程序检查。
10-11:使用软件工具(如 LogiSCOPE)进行代码审查。
11 代码测试、维护
11-1:单元测试要求至少达到语句覆盖。
11-2:单元测试开始要跟踪每一条语句,并观察数据流及变量的变化。
11-3:清理、整理或优化后的代码要经过审查及测试。
11-4:代码版本升级要经过严格测试。
11-5:使用工具软件对代码版本进行维护。
11-6:正式版本上软件的任何修改都应有详细的文档记录。
11-7:发现错误立即修改,并且要记录下来。
11-8:关键的代码在汇编级跟踪。
11-9:仔细设计并分析测试用例,使测试用例覆盖尽可能多的情况,以提高测试
用例的效率。
11-10:尽可能模拟出程序的各种出错情况,对出错处理代码进行充分的测试。
11-11:仔细测试代码处理数据、变量的边界情况。
11-12:保留测试信息,以便分析、总结经验及进行更充分的测试。
11-13:不应通过“试”来解决问题,应寻找问题的根本原因。
11-14:对自动消失的错误进行分析,搞清楚错误是如何消失的。
11-15:修改错误不仅要治表,更要治本。
11-16:测试时应设法使很少发生的事件经常发生。
11-17:明确模块或函数处理哪些事件,并使它们经常发生。
11-18: 坚持在编码阶段就对代码进行彻底的单元测试,不要等以后的测试工作
来发现问题。
11-19:去除代码运行的随机性(如去掉无用的数据、代码及尽可能防止并注意函数中的“内部寄存器”等),让函数运行的结果可预测,并使出现的错误可再现。
12 宏
12-1:用宏定义表达式时,要使用完备的括号。
12-2:将宏所定义的多条表达式放在大括号中。
12-3:使用宏时,不允许参数发生变化。
个人程序设计风格
(1)标识符按意取名。
(2)程序加注释。
①说明每个模块的用途、功能。
②说明模块的接口:调用形式、参数描述及从属模块的清单。
③数据描述:重要数据的名称、用途、限制、约束及其他信息。
④开发历史:设计者、审阅者姓名及日期,修改说明及日期。
功能性注释嵌入在源程序内部,说明程序段或语句的功能以及数据的状态。注意以下几点:
①注释用来说明程序段,而不是每一行程序都要加注释。
②使用空行或缩格或括号,以便很容易区分注释和程序。
③修改程序也应修改注释。
一.数据说明原则
为了使数据定义更易于理解和维护,有以下指导原则:
(1)数据说明顺序规范,使数据的属性更易于查找,从而有利于测试、纠错与维护。例如按以下顺序:常量寿命、类型说明、全程量说明、局部量说明。
(2)一个语句说明多个变量时,各变量名按字典序排列。
(3)对于复杂的数据结构,要加注释,说明在程序实现时的特点。
二.语句构造原则
语句构造的原则是:简单直接。便于阅读和理解,不同层次的语句采用缩进形式,程序的逻辑结构和功能特征会更加清晰。避免复杂的判定条件,避免多重的循环嵌套。表达式中使用括号以提高运算次序的清晰度等等。
三.输入输出原则:
(1)输入操作步骤和输入格式尽量简单。
(2)检查输入数据的合法性、有效性,报告必要的输入状态信息及错误信息。
(3)输入一批数据时,使用数据或文件结束标志,而不要用计数来控制。
(4)交互式输入时,提供可用的选择和边界值。
(5)当程序设计语言有严格的格式要求时,应保持输入格式的一致性。
(6)输出数据表格化、图形化。
四.追求效率原则
指处理机时间和存储空间的使用,对效率的追求明确以下几点:
(1)效率是一个性能要求,目标在需求分析给出。
(2)追求效率建立在不损害程序可读性或可靠性基础上,要先使程序正确,再提高程序效率,先使程序清晰,再提高程序效率。
(3)提高程序效率的根本途径在于选择良好的设计方法、良好的数据结构算法,而不是靠编程时对程序语句做调整。
腾讯c++编程风格
1.程序的版式
1.1规则:程序块要采用缩进风格编写,缩进的空格数为4个。
1.2规则:缩进或者对齐只能使用空格键,不可使用TAB 键。
1.3规则:相对独立的程序块之间、变量说明之后必须加空行。
1.4规则:较长的语句(>80字符)要分成多行书写。
1.5规则:不允许把多个短语句写在一行中,即一行只写一条语句。
1.6 规则:if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。
1.7规则:代码行之内应该留有适当的空格
1.8建议:程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。
2.注释
2.1规则:源文件头部应进行注释,列出:生成日期、作者、模块目的/功能等。
2.2规则:函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值等。
2.3规则:注释应该和代码同时更新,不再有用的注释要删除。
2.4规则:注释的内容要清楚、明了,不能有二义性。
2.5建议:避免在注释中使用非常用的缩写或者术语。
2.6建议:注释的主要目的应该是解释为什么这么做,而不是正在做什么。如果从上下文不容易看出作者的目的,说明程序的可读性本身存在比较大的问题,应考虑对其重构。
2.7建议:避免非必要的注释。
2.8规则:注释的版式
说明:注释也需要与代码一样整齐排版
1)注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置,不可放在下面,如放于上方则需与其上面的代码用空行隔开。
2)注释与所描述内容进行同样的缩排。
3)将注释与其上面的代码用空行隔开。
4)变量、常量、宏的注释应放在其上方相邻位置或右方。
2.9规则:对于所有有物理含义的变量、常量,如果其命名不是充分自注释的,在声明时都必须加以注释,说明其物理含义。
2.10规则:数据结构声明(包括数组、结构、类、枚举等),如果其命名不是充分自注释的,必须加以注释。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释可放在此域的右方。
2.11建议:对重要变量的定义需编写注释,特别是全局变量,更应有较详细的注释,包括对其功能、取值范围、以及存取时注意事项等的说明。
2.12建议:分支语句(条件分支、循环语句等)需编写注释。
2.13规则:注释不宜过多,也不能太少,源程序中有效注释量控制在20%~30%之间。
3 标识符命名
3.1规则:命名尽量使用英文单词,力求简单清楚,避免使用引起误解的词汇和模糊的缩写,使人产生误解。
3.2规则:命名规范必须与所使用的系统风格保持一致,并在同一项目中统一。
3.3建议:变量的命名可参考“匈牙利”标记法(Hungarian Notation):TypePrefix+ Name
3.4规则:常量、宏和模板名采用全大写的方式, 每个单词间用下划线分隔。
3.5建议:枚举类型enum 常量应以大写字母开头或全部大写。
3.6建议:命名中若使用了特殊约定或缩写,则要有注释说明。
3.7规则:自己特有的命名风格,要自始至终保持一致,不可来回变化。
3.8规则:对于变量命名,禁止取单个字符(如i、j、k...),建议除了要有具体含义外,还能表明其变量类型、数据类型等,但i、j、k作局部循环变量是允许的。
3.9建议:除非必要,不要用数字或较奇怪的字符来定义标识符。
3.10建议:函数名以大写字母开头,采用谓-宾结构(动-名),且应反映函数执行什么操作以及返回什么内容。
3.11建议:类、结构、联合、枚举的命名须分别以C、S、U、E开头,其他部分遵从一般变量命名规范。
4 可读性
4.1规则:用括号明确表达式的操作顺序,避免使用默认优先级。
4.2建议:不要编写太复杂 、多用途的复合表达式。
4.3规则:涉及物理状态或者含有物理意义的常量,避免直接使用数字,必须用有意义的枚举或常量来代替。
4.4规则:禁止使用难以理解,容易产生歧义的语句。
5 变量、结构
5.1建议:尽量少使用全局变量,尽量去掉没必要的公共变量。
5.2规则:变量,特别是指针变量,被创建之后应当及时把它们初始化,以防止把未被初始化的变量当成右值使用。
5.3建议:仔细设计结构中元素的布局与排列顺序,使结构容易理解、节省占用空间,并减少引起误用现象。
5.4建议:留心具体语言及编译器处理不同数据类型的原则及有关细节。
5.5建议:尽量减少没有必要的数据类型默认转换与强制转换。
5.6规则:当声明用于分布式环境或不同CPU间通信环境的数据结构时,必须考虑机器的字节顺序、使用的位域及字节对齐等问题。
6 函数、过程
6.1规则:调用函数要检查所有可能的返回情况, 不应该的返回情况要用ASSERT来确认。
6.2建议:编写可重入函数时,应注意局部变量的使用(如编写C/C++语言的可重入函数时,应使用auto即缺省态局部变量或寄存器变量)。
6.3建议:调用公共接口函数时,调用者有保障调用参数符合要求的义务。作为一种防御性的编程风格,被调用函数也应该对传入参数做必要的安全检查。
6.4建议:函数的规模尽量限制在100行以内。
6.5建议:一个函数仅完成一件功能。
6.6建议:不能用ASSERT代替必要的安全处理代码,确保发布版的程序也能够合理地处理异常情况。
6.7尽量写类的构造、拷贝构造、析构和赋值函数 ,而不使用系统缺省的。
6.8建议:对于不需要拷贝构造函数时,应显式地禁止它,避免编译器生成默认的拷贝构造函数。
6.9建议:谨慎使用与程序运行的环境相关的系统函数。
6.10建议:禁止编写依赖于其他函数内部实现的函数。
6.11规则:检查函数所有参数与非参数的有效性。
6.12建议:函数实现中不改变内容的参数要定义成const。
6.13规则:函数的返回值要清楚、明了,让使用者不容易忽视错误情况。
7 C++专用规范
7.1规则:在高警告级别下干净地编译。
7.2规则:确保资源为对象所占有,使用显式的RAII和智能指针。
7.3规则:主动使用const,避免使用宏。
7.4规则:合理使用组合(composition)和继承(inheritance)。
7.5规则:尽可能局部地声明变量。
7.6规则:通过值,(智能)指针,或引用适当地取得参数。
7.7规则:不要在头文件中定义具有链接属性的实体。
7.8规则:尽量用异常来报告错误。
11 附则
1规则:在保证软件系统的正确性、稳定性、可读性及可测性的前提下,提高代码效率。
2规则:局部效率应为全局效率服务,不能因为提高局部效率而对全局效率造成影响。
3.建议:通过对系统数据结构的划分与组织的改进,以及对程序算法的优化来提高空间效率。
4规则:循环体内工作量最小化
5建议:对模块中函数的划分及组织方式进行分析、优化,改进模块中函数的组织结构,提高程序效率。
6建议:避免循环体内含判断语句,应将循环语句置于判断语句的代码块之中。
7建议:在逻辑清楚且不影响可读性的情况下,代码越少越好。
8规则:尽量使用标准库函数,不要“发明”已经存在的库函数。
9建议:要尽量重用已有的代码,直接调用已有的API 。
附录B
1规则:只引用属于自己的存贮空间。
2规则:防止引用已经释放的内存空间。
3规则:过程/函数中动态分配的资源(包括内存、文件等),在过程/函数退出之前要释放。
4建议:充分理解new/delete,malloc/free 等指针相关的函数的意义,对指针操作时需小心翼翼。
5规则:防止内存操作越界。
6建议:要时刻注意易混淆的操作符。当编完程序后,应从头至尾检查一遍这些操作符,以防止拼写错误。
7建议:条件表达式要把常量写在前面。
8建议:有可能的话,if语句尽量加上else分支,对没有else分支的语句要小心对待;switch语句必须有default分支。
9规则:尽量少用goto语句。
10规则:不使用与硬件、操作系统、或编译器相关的语句,而使用建议的标准语句,以提高软件的可移植性和可重用性。
11建议:时刻注意表达式是否会上溢、下溢。
12规则:使用第三方提供的软件开发工具包或控件时,要注意以下几点:
1)充分了解应用接口、使用环境及使用时注意事项。
2)不能过分相信其正确性。
3)除非必要,不要使用不熟悉的第三方工具包与控件。
13规则:资源文件(多语言版本支持),如果资源是对语言敏感的,应让该资源与源代码文件脱离,具体方法有下面几种:使用单独的资源文件、DLL文件或其它单独的描述文件(如数据库格式)。
14规则:打开编译器的所有告警开关对程序进行编译,并且要确认、处理所有的编译告警。
15建议:通过代码走读及审查方式对代码进行检查。
16建议:如果可能,单元测试要覆盖98%以上的代码,尽可能早地发现和解决问题。
17建议:如果可能,尽量使用pc-lint,purify,LogiScope 等测试工具,以提高效率。