谷歌最佳实践 - 代码审核的速度

来源

代码审核的速度

为什么代码审核要快?

在谷歌,我们会对一个开发团队交付产品的速度进行优化,另外一面就是优化独立开发者的编码速度。独立开发者的速度很重要,但是绝对无法与整组的速度相比。
如果代码审核太慢,就会产生下面的影响:

  • 整组的效率会降低。当审核不能快速反馈时,单个开发可以投入其他的工作。然而对于小组来讲,新功能或者bug修复可能就会因为代码审核被延迟数天、数周甚至数月。
  • 开发者会反对代码审核流程。如果审核者每次都需要数日才能有反馈,但是要求主要变更每次都要审核,开发者会感到沮丧和麻烦。大家会认为审核过程太过“严厉”。如果审核者要求同样可靠的变更(变更真实的提高了代码质量),但是在每次开发者提交更新时都能够快速响应,这样的抱怨就会消失。大部分关于代码审核流程的抱怨都能够在加快审核速度之后切实消除掉。
  • 代码质量会受到冲击。当审核很慢时,会对开发者产生持续增加的压力,使得他们没办法以最好的状态提交代码。缓慢的审核也会影响代码整理、重构和基于现有代码的改进的意愿热情。

代码审核应该要多块?

如果你当前没有在一项专注的任务中,你就应该在代码提交后尽快进行审核。
针对一次代码审核请求最晚反馈时间不要超过一个工作日。(例如第二天早晨的第一件事)
遵守这些指南的话,意味着一次典型的变更提交应当是会在一天内进行多轮审核(如果有必要)。

速度与打断

有时候个人效率是要高于团队效率的。例如,你正在全身心投入一项需要专注的工作中——比如写代码,这时候不要打断自己来进行代码审核。研究表明,一旦专注平滑的节奏被打断,开发者需要花很长时间才能重回这个状态。所以打断你个人的编码节奏对团队来讲,与让另外一位开发者等待代码审核实际上更昂贵
你应当选择一个空档时间来进行代码审核的工作,比如当前的编码任务完成,午饭之后,会议结束后,或者一次茶歇之后等等。

快速响应

当我们在讨论代码审核的速度时,我们关心的就是响应时间,相对的就是变更提交整体审核并提交共花费多少时间。整个过程理论上应该要快速,但是快速的独立反馈比整体的过程速度更加重要
哪怕有时我们需要花很长的时间来完成整个审核过程,在过程中能够从审核者很快的获得反馈,就能够明显的降低开发者对于“审核慢”的印象。
如果当有提交时你没有足够的时间来做完整的审核,你可以先回复一下你预计什么时候会进行审核,确认其他审核者是否能够有时间来响应,或者先提供一些初始的宽泛通用的建议。(注意:这并不意味着你需要中断你的编码工作来进行反馈,你仍然应该在空档时间进行回应。)
审核者需要在审核工作上投入足够多的时间来确保他们接受提交就意味者“这份代码符合我们的标准”。然而尽量保证单个响应速度要快。

跨时区审核

当存在时区差异的时候,尽量要在他还在办公室的工作时间内回复。如果他们已经下班来,尽量在他们第二天上班前完成审核。

使用评论标志完成审核(LGTM[1]

为了提高审核的速度,会有一些确定的场景应该通过审核,即使他们在变更提交中备注他们还没有完成。下面就是这些情况:

  • 审核者确信开发者能够很好的处理标记出来的所有问题。
  • 待处理的内容很小而且不是必须由当前开发者完成。
    审核者需要明确当前是哪种情况,如果不是那就说明已经处理完毕了。
    评论中说明审核完成特别值得审核者与开发者在不同时区的组织考虑,否则开发者可能要等一整天,然后只为了等到一个通过评审的评论。

大型变更提交

如果某人提交过来的变更非常大,大到你没有足够的时间能够审核,你应当要求开发者将这个提交拆分成几个更小的提交,而不是一次性审核一个很大的提交。这个对于审核者是很有帮助的,虽然可能会增加一些开发者的工作量。
如果说一个大型提交没办法拆分成更小的提交,你也没有足够的时间来完整审核完整个提交,至少可以针对提交的整体设计提出一些评论并且反馈给开发者用于改进。作为审核者的目标之一就是帮助开发者清除障碍或者能够让他们放心的改进代码,而不用太过担心代码质量。

随着时间代码审核的改进

Code Review Improvements Over Time {#time}

如果跟随指南严格执行代码审核,你会发现随着时间变化审核的速度也会越来越快。开发者也能理解如何提高代码质量,变更提交也会比刚开始更好,需要花在审核上面的时间也越来越少。审核者也懂得快速响应,并且不需要在审核过程中加入无意义的延迟。
但是决不要因为考虑到进度原因,在代码审核标准或者质量上妥协 ,事实上在长期的任务执行中,也不会让事情进行的更快。欲速则不达。

紧急情况

某些紧急情况下,变更提交必须非常快通过完整审核过程,这时候质量标准可以适当放松。然后需要根据《什么是紧急情况》一文来判定什么情况是紧急什么不是。

下一篇:如何写代码审核评论


  1. Git 团队协作中常用术语 WIP PTAL CC LGTM 等解释
    WIP :  Work in progress, do not merge yet. // 开发中
    LGTM : Looks good to me. // Riview 完别人的 PR ,没有问题
    PTAL : Please take a look. // 帮我看下,一般都是请别人 review 自己的 PR
    CC : Carbon copy // 一般代表抄送别人的意思
    RFC  :  request for comments. // 我觉得这个想法很好, 我们来一起讨论下
    IIRC  :  if I recall correctly. // 如果我没记错
    ACK  :  acknowledgement. // 我确认了或者我接受了,我承认了
    NACK/NAK : negative acknowledgement. // 我不同意

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容