`

【转】code review的优势

 
阅读更多

  Google确实是一家很酷的公司。不论是在公司内部或是外部,Google都做了很多让人赞叹的的事情。这里我想介绍一些不涉及商业机密,但鲜为外人所知的事情。

  Google的代码之所以优秀原因其实很简单:他们非常重视代码审查。代码审查并不是Google独有的,它被公 认为是一个很好的(提高代码质量的)手段,很多人已经在日常开发中采用代码审查。但我还没有看到哪一家大公司(像Google这样)应用得如此广泛。在 Google,任何的产品或者项目代码在检入(代码仓库)之前都需要进行有效的审查。

  每个人都要参与代码审查,而且这里我指的不是非正式的审查:它是软件开发环节中非常重要而且通用的规则。不仅是产品代码,所有的代码都需要进行审查。审查代码不需要投入很多的精力,但是(与不做审查相比)产生的效果却是天壤之别。

  关于代码审查(code review),Jonathan Danylko 的看法是“代码要经常检查(包括自查和其他同事检查)。不要把别人的检查,看成是对代码风格的苛求。应该把它们看作是有建设性的批评。对个人来说,经常检查你的代码并且自问,“我怎样才能写得更好呢?” 这会加速你的成长,让你成为一个更优秀的程序员。”

  你能从代码审查中收获什么?

  事实显而易见,有另外一个人检查即将提交的代码,能够帮助找到bug。这是代码审查众所周知且经常被提及的好处。但依据我的经验,这是最没有价值的一 个好处。人们确实可以在代码审查中找到bug。然而坦率地说,在代码审查中找到的bug绝大多数都是一些代码作者花上几分钟就能找到的小bug。那些真正 需要花时间才能找到的bug在代码审查中是检查不到的。

  代码审查最大的好处在于它是一种社交的途径。如果你编程的时候就知道会有同事检查你的代码,那么你的程序会有所不 同。你写的代码会更加整洁,有着较好的注释,结构也组织的不错——因为你知道会有人来检查你的代码,而且你很在意他们的意见。如果没有代码审查,你知道代 码会在最后才会审查。因为不是马上就要检查,所以对你而言并不紧迫,因而你不会想着先自检一遍。

  代码审查还有一个更大的好处,就是可以分享知识。在很多的开发团队中,每个人都会负责并且专注于一个核心模块。除 非别的同事负责的模块出现问题导致自己的代码不能运行,否则他们是不会去关注别人的工作。这样产生的结果是,每一个模块的代码只有一个人比较熟悉。假如事 不凑巧,那位程序员正好休假或者离开了公司,那么没有人了解那些代码了。如果有代码审查的环节,那么至少会有两个人熟悉代码——代码的作者和审阅者。审阅 者虽然没有作者对代码那么了解——但是他同样熟悉代码的设计和结构,这些信息是无价之宝。

  当然,没有什么事情是那么简单的。以我的的经验看来,要做好代码审查需要一段时间练习。我注意到经验不足的审阅者通常会落入一些代码审查的陷阱,这些 陷阱往往会造成很多的麻烦,给那些希望尝试代码审查的人们留下了坏印象,成为了他们采纳代码审查的一个主要障碍。

  代码审查最重要规则是对即将提交的代码中查找问题——你需要做的就是确认代码是正确的。而通常会犯的一个错误,也是刚刚接触代码审查的新手容易犯的一个错误,即审阅者会判断这段代码是否按照自己思路来实现。

  当有一个问题需要解决时,通常会有几十种的办法。当选定一个解决方法时,会有百万种代码实现。因此,作为一个审阅者,你的工作不是确保代码是按照你的 方式来编写的——因为这是不可能的事情。审阅者的工作是确保原作者编写的代码是正确的。如果你没有遵守这个规则,你可能会到处碰壁,审查结束时你的心情很 糟糕,对你来说肯定不是一件好事情。

  问题在于这是不自觉就会犯的一个错误。假定你是一个程序员,当你在看一个问题的时候,你会得到一个自己的解决方案——并且你认为你看到的就是这个问题(应该采用的)解决办法。如果想要成为一名好的审查者,你需要知道这是不对的。

  第二个误区就是人们感觉一定要说点什么(才算是做了代码审查)。代码的作者花了很多的时间和精力来编写代码——你难道不应该说点什么吗?

  答案是:你不应该。

  如果只是说“哦,这看起来这不错!”,这永远没错。反之,如果你不断地去查找一些“问题”并加以指责,那么我肯定你的信誉会荡然无存。如果你不断地去制造一些事情来说些什么,那么代码的作者会认为,当你的言论只是为了避免冷场。从此,你的意见不会受到重视。

  第三个误区就是速度。你不应该匆忙完成一次代码审查——但是也不要拖延。你的同事在那里等着你的审查结果。如果你 和同事不愿意抽出时间来做代码审查或者一直拖延,大家会对这次的审查感到厌烦,也会认为以后的代码审查也只会带来麻烦。看起来好像代码审查会打断你的工 作,其实不必如此。你不必要在别人要求你审查的时候马上丢掉手头上的事情。但是在几个小时之内,当你工作中间休息的时候——喝杯茶,去一下洗手间或者聊聊 天,散散步。当你再回来工作的时候,你可以开始并完成这个代码审查。如果你这么做了,没有人会站在你身边一直等着你给出审查结果。
分享到:
评论

相关推荐

    Best kept secrets of peer code review

    首先,我们需要理解“同行代码审查”(Peer Code Review)的概念。这是一种质量保证活动,开发人员互相检查彼此的代码,旨在发现并修复错误,改进设计,以及传播知识和最佳实践。这个过程不仅限于找出错误,还在于...

    极狐:2023中国企业研发高效能白皮书-Code Review篇.pdf

    极狐GitLab作为Code Review工具的代表,具备显著的优势。它提供了全面的集成解决方案,支持自动化工作流,能够帮助企业更有效地进行代码审查。此外,通过最佳实践分享,如海庭齐碳科技和智众医疗的经验,可以为企业...

    Pau Code Review-开源

    【Pau Code Review 开源详解】 Pau Code Review 是一款专为开发者设计的轻量级代码审查工具。这款工具的核心理念在于...通过深入学习和实践,你将能够充分利用 Pau Code Review 的优势,为你的项目带来显著的改进。

    Code Review&JRuby on Rails

    代码审查(Code Review)是软件开发过程中的重要环节,它有助于提升代码质量、确保团队间的知识共享,以及提早发现潜在问题。Peepcode是一家知名的在线教育平台,提供了丰富的编程教程,其中关于Code Review的教程...

    CodeReview:CodeReview是一个Git GUI工具,用于执行以Python3和Qt5编写的代码审查(Diff Viewer)。

    **Git GUI工具Code...总结来说,CodeReview是利用Git的强大功能,结合Python3和Qt5的技术优势,提供了一种高效的代码审查解决方案。它简化了代码审查过程,提高了团队协作的效率,是软件开发项目中不可或缺的工具。

    基于Code_Collaborator和Review_board的代码审工具试用对比说明.pdf

    因其开源性质,Review_Board在成本方面具有明显优势。 #### 三、Code_Collaborator与Review_Board对比分析 ##### 1. 安装便捷性 - **Code_Collaborator**:安装相对简便,不易出错,支持多种操作系统,包括...

    VSCode代码查看工具

    总的来说,VSCode作为一款现代化的代码查看工具,不仅提供了与SourceInsight相媲美的功能,而且在灵活性和扩展性上具有显著优势。无论是初学者还是经验丰富的开发者,都能通过VSCode提升代码阅读和分析的体验。通过...

    Gitlab 代码 review 插件

    在本文中,我们将深入探讨 Gitlab 代码 review 插件的使用、功能和优势。 首先,Gitlab 是一个流行的开源版本控制系统,提供包括代码托管、持续集成/持续部署(CI/CD)、问题跟踪和项目管理在内的全面服务。在 ...

    藏经阁-《基于阿里云的 Nodejs 稳定性实践》.pdf

    6.持续集成和 CodeReview: Nodejs 应用程序可以通过持续集成和 CodeReview 来确保代码的质量和一致性, CodeReview 可以帮助开发者发现代码中的错误和漏洞。 Nodejs 应用程序的稳定性还可以通过阿里云的云效和 ...

    借助SpotBugs将程序错误扼杀在摇篮中.doc

    为了解决这个问题,公司改进了研发流程,增加了code review环节,但这在团队规模扩大和进度压力增大时效率降低。因此,引入自动化工具成为必然选择,SpotBugs就是这样一个解决方案。 静态代码扫描,如SpotBugs,...

    groovy 原版杂志 十月

    #### 函数与Groovy Code Review 在Groovy原版杂志的十月刊中,首先引入了“function(groovy)”这一主题,它旨在深入探讨Groovy编程语言的核心概念与实践技巧。Groovy作为一种灵活的脚本语言,支持多种编程范式,...

    王伟嘉-2018前端工程化,我们该做什么

    Code Review应当是开发流程中的常规环节,不仅仅是为了找出潜在的bug,也为了让团队成员能够相互学习,保持编码风格的一致性。 综上所述,2018年前端工程化应当重点关注构建流程的优化、ES2016+新特性的充分利用、...

    中国企业研发高效能白皮书(合集)

    4. **Code Review**:代码审查是保证代码质量和团队知识共享的关键环节,通过同行评审,团队可以发现潜在的错误,提升代码质量,并促进最佳实践的传播。 5. **价值流管理和研发效能管理**:这两种方法关注整个研发...

    clippy-reviewdog-filter:用于将Clippy与Reviewdog集成的过滤器

    在标签中,“rust”表明这是与Rust语言相关的项目,“linter”再次确认了Clippy的角色,“code-review”和“codereview”强调了其在代码审查过程中的应用,“reviewdog”明确指出了与Reviewdog的关联,...

    OWASP代码审计指南v2.0_英文版.pdf

    3. secure code review 的定义:secure code review是指对软件代码的审查和分析,以发现和修复安全漏洞和隐患,同时还考虑到业务逻辑和安全策略的要求。 4. 代码审计的目的:代码审计的主要目的是发现和修复代码中...

    几个软件研发团队管理的小问题

    - **Code Review制度**:实施严格的代码审查流程,确保每位开发者的代码都能得到反馈和改进。 - **培训和发展**:提供定期的技术培训和个人发展计划,帮助低技能开发者提升能力。 - **伙伴编程**:采用伙伴编程的...

Global site tag (gtag.js) - Google Analytics