代码审查

什么是代码审查?

代码审查是确保错误和错误在进入生产环境之前被捕获和修复的过程。这通常需要开发人员的参与,他们没有直接参与实施正在审查的代码的特定部分。代码审查是更大的质量保证过程的一部分,以确保最终产品完全符合预期。

除了检查源代码的错误之外,代码审查是检查代码库中是否存在最佳实践和[反模式的好方法]

为什么代码审查很重要?

人们经常对各种各样的事情有不同的看法,尤其是在代码方面,这完全可以!但是,当涉及到生产应用程序中使用的代码库时,您需要确保团队中的所有开发人员在命名策略或架构模式方面使用相同的语言。

为什么这很重要?想象一下,A 和 B两个开发人员一起编写应用程序。A 喜欢使用全局单例字符串(也称为[Singleton 模式] )进行状态管理,而 B 更喜欢使用[State 模式] 。他们在应用程序的不同部分工作,将他们的更改直接提交到共享存储库。

然后爱丽丝休假几周离开项目,现在鲍勃必须修复她实现的功能中的错误。他看到全局单例字符串,困惑地将其更改为状态模式实现,就像他之前实现的所有功能一样。

不幸的是,这样做需要两倍的时间来修复错误,因此 B 很快变得恼火和失望。

如果他们从一开始就实施代码审查流程,A 和 B就会更快地识别出风格上的差异。他们需要的是一个对双方都有意义的协作工作流程。

**代码审查应该涵盖哪些内容? **

让我们来看看成功的代码审查应该涵盖哪些内容以及审查者应该密切关注代码的哪些元素的基本轮廓。

在执行代码审查时,审查代码的人应该关注以下几点:

  • 代码风格
  • 可读性
  • 图案
  • 建筑学

无代码审查的影响

为什么代码审查如此重要?如果没有代码审查或代码审查过多会发生什么?

**1. 可能引入高风险错误。 **

代码审查主要用于查找代码中的错误。如果代码审查太少,或者根本没有代码审查,一些错误很可能会在不被注意的情况下传递到生产中。错误可能会导致低风险(例如错误的 UI)或高风险(例如安全漏洞)。如果没有代码审查,团队几乎没有工具来预测和评估此类风险。

**2. 不一致的代码库。 **

就像 A和 B 的例子一样,人们倾向于喜欢不同的模式和代码风格,并且可能使用不同的方法来管理状态。方法的差异可能会减慢进一步的开发和代码支持。每次你需要实现新的东西或修复一个错误时,开发人员都必须花时间和精力去学习一个新的过程,从而进一步减慢这个过程。

3. 总线因素。

[总线因素] 是指与团队成员之间不共享信息和能力相关的风险度量。

因此,如果只有一个人知道项目的特定部分是如何工作的——编写它的人——并且该人离开了项目,你可能需要执行另一次代码审查,甚至一起重写代码。

太多的代码审查

当涉及到过多的代码审查时,相关的风险很少,但也有一些缺点,可以这么说。进行大量代码审查会导致生产延迟,并可能导致开发人员过分关注满足代码审查,而不是实现高级业务目标。

归根结底,找到黄金中位数很重要。如果您必须优先考虑更快的代码生产,请评估与限制代码审查相关的风险。

代码审查清单

代码审查首先是一个沟通过程。和其他任何人一样,参与其中的每个人都应该感到受到尊重,因为这个过程是高效的。因此,要遵循一些简单的规则,使您的代码审查有用且美观,同时还提供有用的反馈。

如果您是执行审查的人,请考虑以下代码审查清单:

**1. 解释你的意见。 **

在指出错误时,添加一些解释,说明为什么您认为这应该被视为错误。这会让你听起来很自信,也会帮助代码的作者在未来不再犯类似的错误。

另一方面,可能是你错了。解释您来自哪里将有助于鼓励讨论以在意见有任何差异时找到最佳解决方案。

2. 包括示例。

有时,很难理解诸如“根据指南进行更改”或“使用 X 模式”之类的消息。对你来说可能很明显的事情对其他人来说可能是一个完整的谜语。

给出一个简短的例子,说明你认为最终结果应该是什么样子,以帮助作者理解你的想法。

3. 指出具体问题。

“我不知道这段代码有什么问题,但你可以做得更好”并不是很有帮助。确切地告诉代码的作者是什么导致了问题。是内存管理吗?是代码风格吗?

确保提供有用的详细信息,尤其是在解决方案需要作者进一步调查的情况下。大多数时候,当代码没有以令人满意的状态提供时,更好的解决方案不会突然出现在审阅者的脑海中。要求作者进一步调查是可以的,但你应该提供一些方向。

代码审查技巧

人们在合作时工作效率更高。“两个头比一个头好,”对吧?这正是为什么,作为审稿人,您应该尝试听起来友好的原因。保持合作的语气有助于团队专注于解决手头的问题,而不是升级冲突。

以下是一些关于语气的代码审查技巧:

  • 避免责备。
    • 不要说:“你做了坏事”;说:“这样做不好,这就是为什么……” 毕竟,谁编写了错误的代码并不重要。重要的是这段代码是否得到修复。所以专注于评论代码而不是开发人员。
  • 代码审查不是性能评估。
    • 简单地告诉某人他们不够好并不能帮助他们变得更好。将代码审查视为异步结对编程过程的一部分。你不会告诉你的结对编程伙伴他们在编码方面很烂,是吗?相反,你帮助他们纠正错误。这种方法也适用于代码审查。
  • 要有同理心。
    • 代码审查评论充满批评可能会让人不知所措,即使批评写得尽可能友好。当你看到好的代码时,表现出一些同理心和赞美!它可以走很长的路。当开发人员花费时间和精力为团队和产品做一些有价值的事情时,值得注意的是!
  • 对进一步讨论持开放态度。
    • 每个代码审查评论都应该是可讨论的。您可以主动联系参与该流程的任何人以详细说明此事或确保您的团队知道如何与您联系。一个及时的电话甚至几条消息都可以节省大量时间、减少误解和痛苦。

谁应该进行代码审查?

代码审查过程中的主要问题之一是谁应该进行审查?基本上,有两种选择:

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

推荐阅读更多精彩内容