第3部分 软件研发工作总结

同行评审

         在《浪潮之巅》这本书中，吴军老师描述了在Google早期的工作方式，其中有一段是这么写的：我一般会在吃完晚饭后把代码修改的清单发给克雷格做代码审核，他一般晚上10点左右会回复我，给我修改意见，详细到某一行多了一个空格。

        吴军老师所描述的内容，其实就是软件开发中的同行评审流程。

        几乎在所有的软件项目中，都需要同行评审。一个人不管能力多强，看问题的角度总会受到限制，写出来的程序和文档等定不会是十全十美的。如果能够让懂行的同事给参阅一下，并提出他们认为正确的意见，那么势必会减少软件产品中的缺陷，取得个人难以达到的效果。因此，同行评审流程对于广大的软件工程师来说，是十分重要的，也是不可或缺的。

        1. 什么是同行评审？

        同行评审(Peer Review)是一种结构化的正式评审，由生产者(作者)的同行为识别异常和需要修改的部分而对工作产品进行的有组织、有计划的检查。

        同行评审并不是对个人的工作不信任，其目的是尽早有效地消除软件工作产品中的异常。

         2. 为什么要做同行评审？

        在学校的时候，老师教导我们要独立完成作业，因此，如果你在那个时候对别人的作业或在考试过程中进行“同行评审”，那就是违规的。但软件开发是一项团队性的工作，需要大家协作来完成，所以，那种不愿意公开自己工作成果的做法是行不通的。

        为什么要做同行评审呢？

        第一，凡是人皆有出错的时候，要保证你做出的东西里面的错误尽量少，就需要他人对其进行评审。

        第二，对于软件产品来说，缺陷发现得越早，纠正缺陷所需的费用就越少。因此，在软件的开发阶段，如果严格进行同行评审，那么后续流程中出现的错误就会越少，这也可以为公司节约纠错的成本。

        第三，同行评审过程中发现的错误可作为案例传承下去，避免开发人员再次掉进同一个陷阱。“前事不忘，后事之师”，别人所犯的错误对自己有警示的作用。特别是对于新员工来说，经常参与同行评审，可减少试错的次数，也能够达到对新工作及早上手的目的。

        3. 同行评审有哪几种类型？

        同行评审的类型包括：审查、走查、单人复审和多人复审等。

        4. 同行评审的对象是什么？

       在产品开发的各阶段中，需要参与同行评审的对象包括：

       (1) 概念阶段：产品需求说明书等。

       (2) 计划阶段：系统方案、项目计划等。

       (3) 开发阶段：详细设计、单元测试规程(方案)、集成测试规程(方案)、代码、数据库脚本等。一般而言，在开始编码之前，先要进行详细设计评审，以确保程序的正确性，减少后续修改带来的不良影响。

       (4) 验证阶段：系统测试计划、系统测试规程(方案)等。

        5. 什么是审查？审查的角色都有哪些？审查的步骤有哪些？有效评审的原则有哪些？

        审查是同行评审的一种，在软件项目中占有重要地位。

        (1) 审查定义：审查(Inspection)是一种正规的同行评审，适用于重要性和重复性较高的软件工作产品。

        (2) 审查(评审)角色：包括主持人、讲解员、记录员、作者和审查员。一般说来，参与审查的人有3到7人。各角色的分工如下：

        1) 主持人：需要具备领导技巧，负责管理审查过程，是审查流程的关键角色。

        2) 作者：提供审查材料，并提供概要介绍；此外，作者也可以充当评审员。

        3) 记录员：按照主持人的示意记录产品和程序等的异常，在记录的同时要记录异常分类，并大声朗读记录下来的缺陷。

        4) 讲解员：充分理解审查材料，并在讲解的同时加以解释。该角色不能由作者担当。

        5) 审查员：所有参与审查的人员都可以是评审员；主要负责理解被审材料、进行个人检查、做好准备并参加审查会议。

        (3) 审查活动的步骤有7个，如下图所示：

        (4) 有效评审的原则包括：

        1) 在预审期间要使用检查单，以避免发现缺陷不知道记录在哪里的情况发生。

        2) 避免过度依赖检查单。

        3) 审查会议要限制在2小时之内，以避免长时间讨论而偏离了审查会议的主题。

        4) 审查的对象是产品而非生产者(作者)，因此要避免对作者本人进行人身攻击。

        5) “磨刀不误砍柴工”，要给评审员提供足够的预审时间，一般以提前两天为佳。

        6) 如果有与会人员未准备好，则将会议延期；如果有人确实抽不出时间，则取消评审。

        6. 什么是代码评审？其目的是什么？

        对于软件开发工程师来说，代码评审是不可缺少的一个环节，也是提高代码质量的一种有效的手段。

        (1) 代码评审的定义：代码评审是一种正式的针对程序发起的一项同行评审活动，它由一组职责明确的主持人、作者、记录员、审查员等人员通过一系列明确定义的过程对代码进行静态检查来发现代码中的异常。

        (2) 代码评审的目的：提早发现代码缺陷、去除缺陷，以降低开发成本并提高产品质量。

         如前所述，同行评审流程固然重要，但要彻底地执行下去，需要做到以下几点：

        第一，作者本人要持有开放心态，愿意分享自己的工作成果，并勇于承认自身的不足而加以改进。人都不大乐意被别人指出自身的问题，而同行评审的目的就是要发现问题，因此，这在一定程度上是对作者心态的考验，要明白是产品有缺陷，对产品中的问题进行完善。

        第二，评审人员要对事不对人，要懂得同行评审是为了发现产品的缺陷，而非人自身的问题。不要将同行评审活动变性为针对作者本人的人身攻击，这就有伤整个团队的凝聚力。同行评审的一个宗旨就是大家在一起学习，取长补短，共同提高。

        第三，很重要的一点，公司要对同行评审的结果进行总结，并以文档的形式保存起来，方便后期查阅。很多软件产品出现的问题都是相似的，在着手开发产品之前，如果能够了解前期类似产品中出现的问题，那么可以少走很多弯路，节约了工作时间，提高了工作效率。

       为了确保产品的质量，产品的所有工作成果(包括程序、文档、图形等)都应该接受同行评审。“三人行，则必有我师”，不管是老员工，还是新员工，都能够从同行评审中受益。