礼貌

通常来说当你进行评审代码时保持礼貌和尊重很重要,这也能使开发人员更加清晰,得到更多帮助。这样是为了保证你的代码评论仅仅针对的是code而不是针对开发人员。你不必一直这么去做,但是当你的评论会让开发人员生气或者产生争执时有必要这么去做。比如:
反例: “为什么会在这里使用线程,这样做没有任何好处?”
正例: “我并没有发现这个并发模块给程序带来了多少帮助,并且还增加了程序的复杂性,因此我认为这段代码最好是用单线程而不是多线程“。

解释清楚原因

从上面“正面”的例子当中你能发现,这样有助于开发人员理解为什么你写了这些评注。你不一定非得包含这些信息在你的评注里面,但是适当的多解释你的意图或者多给出一些提升代码质量的建议都是非常好的实践。

给予指导

通常来说修复CL是开发人员的职责而不是评审人员的。你不需要向开发人员提供详细的解决方案或者代码。
但是这并不意味着评审员就不应该提供帮助。你需要在指出问题和提供直接指导之间找到平衡。指出问题并让开发人员做出决定通常可以帮助开发人员学习,并使代码审查更容易。这也可以带来更好的解决方案,因为开发人员比审阅者更接近代码。有时直接的指令,建议甚至代码会对代码审查更有帮助。代码审查的主要目标是获得最佳的CL。第二个目标是提高开发人员的技能,以便他们随着时间的流逝进行审查的次数越来越少。

接受解释

与其要求让开发人员解释一段你看不懂的代码,其实更应该做的是让他们重写代码,让代码更清晰。当一段代码不是很复杂的时候,加一些注释也是一种不错的做法。**