代码审查规范.docx

,通过这个机制我们可以对代码、测试过程和注释进行检查。CodeReview主要用来在软件工程过程中改进代码质量,通过CodeReview可以达到如下目的:在项目早期就能够发现代码中的BUG。帮助初级开发人员学习高级开发人员的经验,达到知识共享。避免开发人员犯一些很常见,很普通的错误。保证项目组人员的良好沟通。项目或产品的代码更容易维护。 ,开发者必须确保代码符合如下条件,审核者需要确保所有前提条件都已满足方可开始审查,同时也是审查的主要检查点。所有代码注释清晰,语法正确,编译通过。日志代码完整,业务日志、系统日志分开,中文描述,脱敏处理,状态变更,全部清晰明确。测试代码覆盖全部分支和流程,暂时统一使用工具Emma(各编译器可下载对应插件)进行CoverageCheck。项目引用关系明确,依赖关系清晰,配置文件描述。 、编码风格、代码的安全问题、脱敏问题、代码冗余、是否正确设计以符合设计要求(性能、功能)与设计文档相同等等。、pleteness)代码是否完全实现了设计文档中所涉及的所有流程和功能点代码是否已包含所有所需的业务日志、系统日志、异常日志,日志内容是否完整,日志文件配置是否正确。代码是否使用缓存等,配置信息是否正确可配置。代码中是否存在任何没有定义或没有引用到的变量、、一致性检查(Consistency)代码的逻辑是否符合设计文档代码中使用的格式、符号、、正确性检查(Correctness)、可修改性检查(Modifiability)代码涉及到的常量是否易于修改(如使用配置、定义为类常量、使用专门的常量类等)代码中是否包含了交叉说明或数据字典,以描述程序是如何对变量和常量进行访问的代码是否只有一个出口和一个入口(严重的异常处理除外)、可预测性检查(Predictability)、健壮性检查(Robustness)代码是否采取措施避免运行时错误(如数组边界溢出、被零除、值越界、堆栈溢出等)、结构性检查(Structuredness)、可追溯性检查(Traceability)代码是否对每个程序进行了唯一标识是否有一个交叉引用的框架可以用来在代码和开发文档之间相互对应代码是否包括一个修订历史记录,、可理解性检查(Understandability)注释是否足够清晰的描述每个子程序是否使用到不明确或不必要的复杂代码,它们是否被清楚的注释使用一些统一的格式化技巧(如缩进、空白等)用来增强代码的清晰度是否在定义命名规则时采用了便于记忆,反映类型等方法每个变量都定义了合法的取值范围代码中的算法是否符合开发文档中