查看CL(提交列表)

既然您已經(jīng)知道Code Review應(yīng)該Review什么为鳄,那么管理跨多個(gè)文件的評審的最有效方法是什么呢?

  • 這種變更合理嗎?它有一個(gè)好的描述嗎?
  • 首先查看最主要部分的變更咽袜。它的整體設(shè)計(jì)好嗎?
  • 按照適當(dāng)?shù)捻樞虿榭碈L的其余部分。

第一步:從更廣闊的角度看待變更

查看CL的描述和CL的一般功能。這種變更合理嗎?如果這個(gè)變更一開始就不應(yīng)該發(fā)生,請立即解釋為什么不應(yīng)該變更切省。當(dāng)您拒絕這樣的變更時(shí),向開發(fā)人員建議他們應(yīng)該做什么也是一個(gè)好主意杈抢。

例如数尿,你可以說“看起來你在這方面做得不錯(cuò),謝謝!但是惶楼,我們實(shí)際上是要?jiǎng)h除您在這里修改的FooWidget所在的系統(tǒng)右蹦,所以我們現(xiàn)在不想對它進(jìn)行任何新的修改。不如重構(gòu)我們的新BarWidget類?”

請注意歼捐,評審人不僅拒絕了當(dāng)前的CL并提供了一個(gè)替代的建議何陆,而且還很有禮貌。這種禮貌是很重要的豹储,因?yàn)槲覀兿胍憩F(xiàn)出我們作為開發(fā)者彼此尊重贷盲,即使我們意見不一致。

如果您得到了多個(gè)您不希望進(jìn)行變更的CLs,那么您應(yīng)該考慮為外部貢獻(xiàn)者或您的團(tuán)隊(duì)重新制定開發(fā)流程或發(fā)布的流程巩剖,以便在編寫CLs之前進(jìn)行更多的溝通铝穷。在人們做了大量的工作,最好在不得不扔掉或徹底重寫之前佳魔,對他們說“不”曙聂。

第二步:檢查CL的主要部分

找到一個(gè)或多個(gè)文件是這個(gè)CL的“主要”部分。通常鞠鲜,有一個(gè)文件的邏輯更改數(shù)量最多宁脊,它是CL的主要部分。首先看看這些主要部分贤姆。這有助于為CL的所有更小的部分提供上下文榆苞,并且通常會(huì)加速代碼檢查。如果CL太大霞捡,您無法確定哪些部分是主要部分坐漏,請?jiān)儐栭_發(fā)人員應(yīng)該首先查看哪些部分,或者請他們將CL分成多個(gè)CL弄砍。

如果您看到CL的這一部分存在一些主要的設(shè)計(jì)問題仙畦,您應(yīng)該立即發(fā)送這些評論输涕,即使您現(xiàn)在沒有時(shí)間來查看CL的其余部分音婶。

實(shí)際上,檢查CL的其余部分可能是浪費(fèi)時(shí)間莱坎,因?yàn)槿绻O(shè)計(jì)問題足夠嚴(yán)重衣式,那么很多其他正在檢查的代碼將會(huì)被刪除,不管怎樣都無關(guān)緊要檐什。

有兩個(gè)非常重要原因需要我們立即評論這些關(guān)于主要的設(shè)計(jì)的問題:

  • 開發(fā)人員通常會(huì)發(fā)送一個(gè)CL碴卧,然后在等待評審期間立即根據(jù)這個(gè)CL開始新的工作。如果您正在審查的CL中存在主要的設(shè)計(jì)問題乃正,那么他們也將不得不重新處理后面的CL住册。你想在他們在有問題的設(shè)計(jì)上做太多額外的工作之前避免這種情況的發(fā)生。
  • 主要的設(shè)計(jì)變更比小的變更需要更長的時(shí)間瓮具。開發(fā)人員幾乎都有最后期限;為了在最后期限前完成這些工作荧飞,并且在代碼庫中仍然有高質(zhì)量的代碼,開發(fā)人員需要盡快開始對有設(shè)計(jì)問題的CL進(jìn)行重寫名党。

第三步:按照適當(dāng)?shù)捻樞虿榭碈L的其余部分

一旦您確認(rèn)了CL整體上沒有重大的設(shè)計(jì)問題叹阔,那么請嘗試找出一個(gè)邏輯順序來檢查這些文件,同時(shí)確保您不會(huì)錯(cuò)過檢查任何文件传睹。通常耳幢,在您瀏覽完主要文件之后,最簡單的方法就是按照代碼審查工具顯示文件的順序?yàn)g覽每個(gè)文件欧啤。有時(shí)睛藻,在閱讀主代碼之前先閱讀測試也是有幫助的启上,因?yàn)檫@樣您就會(huì)對變更應(yīng)該做什么有一個(gè)概念。

下一章: Review的速度

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末店印,一起剝皮案震驚了整個(gè)濱河市碧绞,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌吱窝,老刑警劉巖讥邻,帶你破解...
    沈念sama閱讀 211,376評論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異院峡,居然都是意外死亡兴使,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,126評論 2 385
  • 文/潘曉璐 我一進(jìn)店門照激,熙熙樓的掌柜王于貴愁眉苦臉地迎上來发魄,“玉大人,你說我怎么就攤上這事俩垃±祝” “怎么了?”我有些...
    開封第一講書人閱讀 156,966評論 0 347
  • 文/不壞的土叔 我叫張陵口柳,是天一觀的道長苹粟。 經(jīng)常有香客問我,道長跃闹,這世上最難降的妖魔是什么嵌削? 我笑而不...
    開封第一講書人閱讀 56,432評論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮望艺,結(jié)果婚禮上苛秕,老公的妹妹穿的比我還像新娘。我一直安慰自己找默,他們只是感情好艇劫,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,519評論 6 385
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著惩激,像睡著了一般店煞。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上咧欣,一...
    開封第一講書人閱讀 49,792評論 1 290
  • 那天浅缸,我揣著相機(jī)與錄音,去河邊找鬼魄咕。 笑死衩椒,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播毛萌,決...
    沈念sama閱讀 38,933評論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼苟弛,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了阁将?” 一聲冷哼從身側(cè)響起膏秫,我...
    開封第一講書人閱讀 37,701評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎做盅,沒想到半個(gè)月后缤削,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,143評論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡吹榴,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,488評論 2 327
  • 正文 我和宋清朗相戀三年亭敢,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片图筹。...
    茶點(diǎn)故事閱讀 38,626評論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡帅刀,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出远剩,到底是詐尸還是另有隱情扣溺,我是刑警寧澤,帶...
    沈念sama閱讀 34,292評論 4 329
  • 正文 年R本政府宣布瓜晤,位于F島的核電站锥余,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏活鹰。R本人自食惡果不足惜哈恰,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,896評論 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望志群。 院中可真熱鬧,春花似錦蛔钙、人聲如沸锌云。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,742評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽桑涎。三九已至,卻和暖如春兼贡,著一層夾襖步出監(jiān)牢的瞬間攻冷,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,977評論 1 265
  • 我被黑心中介騙來泰國打工遍希, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留等曼,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,324評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像禁谦,于是被迫代替她去往敵國和親胁黑。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,494評論 2 348

推薦閱讀更多精彩內(nèi)容

  • 注意:在考慮這些要點(diǎn)時(shí)州泊,一定要考慮到Code Review標(biāo)準(zhǔn) 設(shè)計(jì) 在評審中最重要的是CL的整體設(shè)計(jì)丧蘸。CL中不同...
    老貓_jerry閱讀 628評論 0 1
  • 去年有段時(shí)間得空,就把谷歌GAE的API權(quán)威指南看了一遍遥皂,收獲頗豐力喷,特別是在自己幾乎獨(dú)立開發(fā)了公司的云數(shù)據(jù)中心之后...
    騎單車的勛爵閱讀 20,475評論 0 41
  • feisky云計(jì)算、虛擬化與Linux技術(shù)筆記posts - 1014, comments - 298, trac...
    不排版閱讀 3,827評論 0 5
  • 從有了微信開始,就停用QQ了演训,大概四年多了吧冗懦。最近偶然登錄QQ,翻看以往的說說仇祭,很是感慨披蕉。 QQ里的說說非常隨性,...
    知識(shí)管理某李閱讀 355評論 0 0
  • 1.我傲嬌地認(rèn)為乌奇,言語是魔法世界永不枯竭的資源没讲。他既能造成傷害,也能修復(fù)他礁苗。 2.也許他正發(fā)生在你的腦中爬凑,但究竟為...
    簡字旁閱讀 524評論 0 2