C语言编程规范

C语言编程规范简介基本原则排版PART01PART02PART03C语言编程规范PART04注释PART05标识符命名PART06可读性简介PART01简介代码编写规则应该在建立一个工程项目之前、该规则应该贯穿整个项目的始终以保证代码的一致性。采用标准的代码编写惯例，可以大大简化项目的维护负担。采用一种好的风格，以达到以下目的：可移植性、连贯、整洁、易于维护、易于理解、简洁。基本原则PART02制定标准的基本目的是加强代码的可维护性。也就是说代码必须易于阅读，易于理解，易于测试，易于移植。保持代码的简单清晰，不要在语言中使用晦涩难懂的表述，直接表明你的思想。保存一致性，尽可能使用同样的规则。避免使用复杂语句，一个语句若有太多的决策点将会使代码难于理解，尤其是对于测试。基本原则排版PART03程序块缩进一行不要超过80列代码群落加空行排版操作符流程控制语句必须用大括号包含起来排版程序块缩进程序块要采用缩进风格编写，缩进的空格数为4个。在编码之前对相关IDE进行设置，如若没有缩进设置，需要在编写完代码后使用相关工具格式化代码。代码群落加空行相对独立的程序块之间、变量说明之后必须加空行。如这样是不符合规范的，只有如左图这样写才是符合规范的较长的语句(80字符)要分成多行书写，长表达式要在低优先操作符处划分新行，操作符放新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。循环、判断等语句中若有较长的表达式或语句，则要进行适当的划分，长表达式要在低优先级操作符处分新行，操作符放在新行之首。若函数或过程中的参数较长，则要进行适当的划分。不允许把多个短语写在一行中，即一行只写一条语句。一行不要超过80列if、for、do、while、case、switch、default等语句自占一行，且if、for、do、while等语句的执行语句无论多少行都要加大括号{}。流程控制语句必须用大括号包含起来操作符在两个以上的关键字、变量、常量进行对等操作时。它们之间的操作符之前、之后或者前后都要加空格；进行非对等操作时，如果关系密切的立即操作符（如-），后不应加空格。注释PART04注释注释的原则是有助于对程序的阅读理解以及提供二次开发所需文档，遵循原则为，说明性文件、函数接口必须充分注释说明。全局变量需要说明功能及取值范围，需要自行处理资料函数需要加上使用警告信息。不要使用注释来屏蔽代码。关于函数和局部变量的注释，当代码已经可自注释时，不用添加多余的注释。标识符命名PART05变量宏全局变量函数标识符命名标识符的命名要清晰、明了，有明确含义，同时使用完整的单词或大家基本可以理解的缩写，避免使人产生误解。命名中若有使用特殊约定或缩写，则要有注释说明。整个工程自始自终的命名风格保持一致，不可来回变化。可读性PART06可读性1、算法优先级注意运算符的优先级,并用括号明确表达式的操作顺序，避免使用默认优先级。防止阅读程序时产生误解，防止因默认优先级与设计思想不符而导致程序错误。2、使用有意义的标识代替不易理解的数字避免使用不易理解的数字，用有意义的标识来替代。3、少用技巧性很高的语句不要使用难懂的技巧性很高的语句，除非很有必要时。高技巧语句不等于高效率的程序，实际上程序的效率关键在于算法。。谢谢大家