程序員必備的代碼審查(Code Review)清單

在我們關于高效代碼審查的博文中,我們建議使用一個檢查清單。在代碼審查中,檢查清單是一個非常好的工具——它們保證了審查可以在你的團隊中始終如一的進行。它們也是一種保證常見問題能夠被發現并被解決的便利方式。

轉自伯樂在線

軟件工程學院的研究表明,程序員們會犯15-20種常見的錯誤。所以,通過把這些錯誤加入到檢查清單當中,你可以確保不論什么時候,只要這些錯誤發生了,你就能發現它們,并且可以幫助你杜絕這些錯誤。
為了幫助你開始創建一個清單,這里列出了一些典型的內容:代碼審查清單。

常規項####

  1. 代碼能夠工作么?它有沒有實現預期的功能,邏輯是否正確等。
  2. 所有的代碼是否簡單易懂?
  3. 代碼符合你所遵循的編程規范么?這通常包括大括號的位置,變量名和函數名,行的長度,縮進,格式和注釋。
  4. 是否存在多余的或是重復的代碼?
  5. 代碼是否盡可能的模塊化了?
  6. 是否有可以被替換的全局變量?
  7. 是否有被注釋掉的代碼?
  8. 循環是否設置了長度和正確的終止條件?
  9. 是否有可以被庫函數替代的代碼?
  10. 是否有可以刪除的日志或調試代碼?

安全####

  1. 所有的數據輸入是否都進行了檢查(檢測正確的類型,長度,格式和范圍)并且進行了編碼?
  2. 在哪里使用了第三方工具,返回的錯誤是否被捕獲?
  3. 輸出的值是否進行了檢查并且編碼?
  4. 無效的參數值是否能夠處理?

文檔####

  1. 是否有注釋,并且描述了代碼的意圖?
  2. 所有的函數都有注釋嗎?
  3. 對非常規行為和邊界情況處理是否有描述?
  4. 第三方庫的使用和函數是否有文檔?
  5. 數據結構和計量單位是否進行了解釋?
  6. 是否有未完成的代碼?如果是的話,是不是應該移除,或者用合適的標記進行標記比如‘TODO’?

測試####

  1. 代碼是否可以測試?比如,不要添加太多的或是隱藏的依賴關系,不能夠初始化對象,測試框架可以使用方法等。
  2. 是否存在測試,它們是否可以被理解?比如,至少達到你滿意的代碼覆蓋(code coverage)。
  3. 單元測試是否真正的測試了代碼是否可以完成預期的功能?
  4. 是否檢查了數組的“越界“錯誤?
  5. 是否有可以被已經存在的API所替代的測試代碼?

優化你的清單####

把使用清單作為你的起點,針對特定的使用案例,你需要對其進行優化。一個比較棒的方式就是讓你的團隊記錄下那些在代碼審查過程中臨時發現的問題,有了這些數據,你就能夠確定你的團隊常犯的錯誤,然后你就可以量身定制一個審查清單。確保你刪除了那些沒有出現過的錯誤。(你也可以保留那些出現概率很小,但是非常關鍵的項目,比如安全相關的問題)。
得到認可并且保持更新
基本規則是,清單上的任何條目都必須明確,而且,如果可能的話,對于一些條目你可以對其進行二元判定。這樣可以防止判斷的不一致。和你的團隊分享這份清單并且讓他們認同你清單的內容是個好主意。同樣的,要定期檢查你的清單,以確保各條目仍然是有意義的。
有了一個好的清單,可以提高你在代碼審查過程中發現的缺陷個數。這可以幫助你提高代碼標準,避免質量參差不齊的代碼審查。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,401評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,011評論 3 413
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 175,263評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,543評論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,323評論 6 404
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,874評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 42,968評論 3 439
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,095評論 0 286
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,605評論 1 331
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,551評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,720評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,242評論 5 355
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 43,961評論 3 345
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,358評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,612評論 1 280
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,330評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,690評論 2 370

推薦閱讀更多精彩內容