如何做好Code Review - 麦机长 - 博客园

标签: | 发表时间:2021-01-13 09:29 | 作者:
出处:https://www.cnblogs.com

Code Review(代码审查)很多团队都会做,效果如何不好说。如果你能轻易地从一堆出自正经团队之手的代码里找出几个低级错误,往往意味着团队管理者长期忽视了Code Review的重要性。

根据经验,匆匆应付功能实现和漏洞修复而将Code Review流于形式的团队不在少数。当然,每个人都能列举一大堆“客观原因”,而且每一条理由听起来都是那么的有说服力。然而,没做好就是没做好,狡辩只会让场面变得更加恶心。

What(什么是Code Review)

A code review is the process of examining written code with the purpose of highlighting mistakes in order to learn from them.

-- Techopedia

这是目前我见过对Code Review最言简意赅的定义。其实怎么描述并不重要,重要的是我们要达到什么样的目的。

Why(为什么要做Code Review)

提高代码质量是程序员端稳饭碗、少挨点儿骂的最有效途径。其实Code Review就是很好的相互切磋、共同进步的机会,效果要比独自埋头干啃《21天精通×××》之类的“宝典”好得多。当然,前提是目的明确、态度端正。

Code Review主要目的就两个:

查错

Code Review不是用来查找低级错误的,而是参与者以提交者以外的视角阅读和审视代码,尽可能地找到逻辑上的问题。

学习

与其说Code Review重在找到问题,不如说其核心目的在于营造团队学习氛围、提升成员对软件品质的追求。我经历过不少团队,为了营造学习氛围,生拉硬拽地要求成员定期举行技术分享会,结果往往敷衍了事、不了了之。

How(怎样做Code Review)

下面根据Code Review中涉及的主要人物角色来讲讲我推荐的方式。注意,这不是标准答案。

具体划分角色责任之前,我建议每个技术团队都要找到并严格执行适合本团队技术栈的编码规范,甚至包括IDE配置和开发环境参数设定等,以确保每位成员都“说着同样的语言”,并减少在命名规则、排版样式等方面的争论,将时间和精力聚焦到对功能实现和业务优化这些实质性的问题上来。

开发小组技术负责人

每一位开发小组技术负责人都应该积极实施并维护Code Review机制,要求每位成员在提交代码的时候,都必须经过交叉Review,也就是每一次代码提交到主干时,都必须经过另一位相同技术领域同事的Review,否则将被视为提交了与存在编译时错误的代码同等的严重过失。

每次代码提交的交叉Review,开发小组技术负责人应当随机抽取包括自己在内的任何一位技术人员进行,不要让提交者能够很轻易地预知将会是谁来做自己这一次的Reviewer,否则很容易变成形式主义。

并且,对于Feature实现的Code Review,开发小组技术负责人应该较为频繁但不定期地进行公开Review。组织一场会议,召集整个开发小组的成员一起对此次提交的代码进行审查。

提交者

不论Code Review是私下的还是公开的,提交者都不能提交任何存在编译时错误的代码,这是非常低级的错误。首先在提交代码之前再次进行编译,是确保即将提交的代码不存在编译时错误的必要步骤。其次,也是很多人容易疏忽的,确保本次新增的本地资源文件都被加入了源代码管理,否则即使本地能编译通过,别人拿到你的代码也依然存在编译时问题。

提交代码之前,自己先 diff一下,首先确保代码不存在前面提到的诸如命名、格式等方面的低级错误;然后确定自己对每一处代码变动的理解都非常明确,并且自己已经找不出改进方案;最后确保所有Hard Code都已经被移除,这一点可以参考我之前写的 《没什么技术含量的Remove Before Flight》

提交者在代码被Review之前,还应该调整好心态,把别人的询问、质疑、建议、批评,通通视作可能的提升机会,而不要主观上认定自己给出的就是最优解,而别人都是“不明真相的围观群众”。也许别人在不了解背景信息或上下文的情况下,给出了错误的建议,提交者也应当将此作为锻炼思维和口才的友好辩论,而不是玻璃心受到了侵犯似的直接怼回去。

参与者

参与者应该对编码规范了然于心,对于代码中每一处不符合团队现行编码规范的地方都要不厌其烦地标注出来。很多人认为这个无所谓,反正机器最后读的都是0和1——对,机器只认识0和1,所以源代码其实是写给人看的。不管代码由多少人写就,最终看上去如同出自同一人之手,这种代码的阅读体验和效率绝对要比那种百家争鸣式的好得多。

如果是面向对象的编程语言,参与者应当考察提交者对抽象的理解和实践,是否准确以及是否过浅或过深。抽象过浅,看上去往往是大杂烩;抽象过深,读起来显得吃力。对于这两种情况,参与者都可以提出自己的看法和建议,不要抱着“你这不行,听我的”的态度,否则很容易形成对立的情绪,进而影响团队对Code Review的积极性。

对于代码实现是否存在改进空间这个问题,参与者应该在阅读新代码时,尽可能全面地去理解问题域、了解需求的具体细节,而不是想当然地抛出质疑和意见,给人以浮躁的印象。如果参与者确定自己清楚地理解了需求和问题,依然对当前的代码实现有改进建议,那么就大胆地提出来,这就是Code Review的核心目的!

相关 [code review 机长] 推荐:

聊聊Code Review

- - 梦想风暴
hopesfish评论《 那一点的调用》时,问了一个关于Code Review的问题:. 想请教一下,TW的筒子是如何做code reivew或者鼓励客户做code review的. 我在翻阅博主的帖子的时候,似乎对这块没有特别强调,而是更多偏重于TDD,我觉得TDD的问题是一碰到没有责任心的程序猿,就很容易流于形式了.

Java Code Review清单

- - ImportNew
使用可以表达实际意图(Intention-Revealing)的名称. DRY(Don’t Repeat Yourself)原则,(拒绝重复). 用代码来解释自己的做法(译者注:即代码注释). *参考自: http://techbus.safaribooksonline.com/book/software-engineering-and-development/agile-development/9780136083238.

如何做好Code Review - 麦机长 - 博客园

- -
Code Review(代码审查)很多团队都会做,效果如何不好说. 如果你能轻易地从一堆出自正经团队之手的代码里找出几个低级错误,往往意味着团队管理者长期忽视了Code Review的重要性. 根据经验,匆匆应付功能实现和漏洞修复而将Code Review流于形式的团队不在少数. 当然,每个人都能列举一大堆“客观原因”,而且每一条理由听起来都是那么的有说服力.

我的code review规则

- vento - 我的宝贝孙秀楠 ﹣C++, Lua, 大连,程序员
1) 是否有语法错误,编译错误,编译警告. 做法:下载最新代码,将编译警告级别提升到最高,检查output信息. 2)是否符合需求,完成requirement文档要求的内容,不能多,也不能少. 注意:即使发现有问题代码,如果与需求关联不大,不要涉及. 应该让每次enhancement和bug fix最简洁,牵涉范围最小,影响到组件最少.

Code Review那些事儿

- - 非技术 - ITeye博客
       曾经有一段 垃圾代码放在我的面前,我没有拒绝,等我真正开始接手的时候我才后悔莫及,程序员最痛苦的事莫过于此. ---------改编于周星星的经典台词.       虽然有点夸张,但编码界确实大大存在这种情况,每当接手别人的代码,都有一种想重新写一遍的感觉,等到别人再来接手你的代码时,同样的感觉.

代码审查(Code Review)清单

- - 博客 - 伯乐在线
代码审查可以帮助提高代码质量,避免由于代码习惯而造成的 bug. 下面列出的这些要点因该可以作为大部分代码审查的指导,如果是 Java 应用的话,这些建议应该被视作最佳实践. Javadoc 应该在每一个类和方法中添加. 如果是修复某个 bug,应该添加 bug ID. 走捷径的方法或者复杂的逻辑要有解释.

从Code Review 谈如何做技术

- - 酷 壳 - CoolShell.cn
(这篇文章缘由我的微博,我想多说一些,有些杂乱,想到哪写到哪). 这两天,在微博上表达了一下Code Review的重要性. 因为翻看了阿里内部的Review Board上的记录,从上面发现Code Review做得好的是一些比较偏技术的团队,而偏业务的技术团队基本上没有看到Code Review的记录.

我们该如何做好Code Review?

- - SegmentFault 最新的文章
我们该如何做好Code Review?. 午后的阳光,静静地照在你的脸上. 这时候配上一杯82年的java,脑子一片灵光闪过,呃......上午刚写完需求,下午好像没什么事了,不如看看自己写的代码. 至此,一场Code Review也就拉开序幕了. Code Review,即代码审查,是指对计算机源代码系统化地审查,常用软件同行评审的方式进行,其目的是在找出及修正在软件开发初期未发现的错误,提升软件质量及开发者的技术.

如何在团队中做好 Code Review

- - IT瘾-dev
一、Code Review的好处. 想要做好Code Review,必须让参与的工程师充分认识到Code Review的好处. 无论是高手云集的架构师团队,还是以CURD为主的业务开发团队,大家的技术能力、经验都是有差异的. 通过Code Review,对于同样的功能实现,有经验的工程师可以给经验尚浅的工程师提供合理的优化建议.