主頁 > 軟體工程 > 談談代碼評審(code review)

談談代碼評審(code review)

2020-09-10 05:21:47 軟體工程

  什么是代碼評審(code review)? 根據維基百科的定義,代碼評審是一種通過若干人員檢閱源代碼方式來進行的軟體質量保證活動,根據軟體工程的經典理論,代碼評審應該是收益很高的活動,因其產生在Coding階段(屬于開發生命周期的早期),在開發生命周期越早發現問題,解決問題的成本越低,工程實踐也能印證這個結論, 代碼評審有以下目標:

  • 提高代碼質量和可維護性(可讀性,一致性)
  • 發現代碼缺陷
  • 知識經驗傳承
  • 發現更好的解決方案
  • 滿足QA指導方針

  本人根據針對網路上某代碼評審最佳實踐的公開文章談談自己的想法,

原則1:每次只評審小于200~400行的代碼,

--》 我的觀點:這個只要是考慮到一次評審的代碼過多,評審者發現問題的能力將大量縮小,如果一次評審過多代碼,會對評審者帶來智力和心理兩方面的挑戰,從智力上來說,拋開極少數智力超群者不談,對普通人來說,一次評審更少量的代碼更容易理解代碼的意圖(同時減少了與代碼作者的溝通成本,提高效率),這也是符合分而治之的解決問題方法論的,從心理上來說,一次評審過多代碼會對評審者產生倦怠感,評審者主觀上通常會降低評審的細致度,根據我的經驗,如果某項軟體開發任務代碼量比較大,可將此任務分解為若干子任務,子任務的劃分粒度盡量做到一周的代碼提交量(提交的代碼需要測驗通過),當然,子任務的劃分是建立在良好的設計檔案基礎上,否則子任務劃分的隨意度比較高且作業量評估容易不準確,

原則2:代碼評審速度應小于每小時300~500行,

--》 我的觀點:這條主要是考慮評審的細致度,細致度越高越能發現更多問題,換算一下,一個20行的函式,評審時間應不少于2~4分鐘,

原則3:檢查清單(checklist)可以大幅改善評審結果

--》 我的觀點:檢查清單對代碼作者和評審者都有作用,對代碼作者來說,可以在編碼的時候就犯止犯類似的錯誤,對評審者來說,可以幫助評審得更全面,特別是找出遺漏的問題,檢查清單可以定期更新,在評審程序中發現的問題都可以對照檢查清單,看看是否需要添加新的條目,最新的檢查清單需要在團隊內公布,最好是放在一個固定的位置方便隨時查看,這個檢查清單可以考慮和編碼規范放在一個檔案,互為對照補充,

原則4:團隊領導者應建立一種正面的評審文化,即應正面看待評審中發現的問題

--》 我的觀點:為什么需要完全正面的看待在評審中發現的問題?如前文所述,在代碼評審中發現問題的修復成本非常低,所以發現越多問題越是好事,只有完全正面看待代碼評審發現的問題,評審者才會有更大的動機會發現更多的問題,對于代碼作者來說,在代碼評審中發現問題,可以幫助自己修正錯誤的編碼習慣和提高自身的編碼能力,同時,完全正面看待評審發現的問題,能使得評審者和代碼作者建立更為和諧的關系,更有利于發現更多問題,為了建立正面評審文化,領導者需要在團隊中宣貫在評審中發現問題表明代碼作者和評審者通過成功的團隊合作提高了代碼質量,領導者絕對不應將評審中發現的問題列入任何針對個人的考核因子,

原則5:輕量級的代碼評審是有效率的和現實的

--》 我的觀點:軟體工程理論中非常正式的代碼評審一般要召集不同角色的工程師,通過召開會議來逐行審查代碼并進行討論,但是這種方式成本比較昂貴,較少有公司能夠負擔起這種人力成本,所以現今大部分公司都傾向于實施非正式的代碼評審,一般是基于工具,最簡單的非正式代碼評審可以是基于郵件串列,缺點是無法很好的記錄評審程序中的修改歷史和溝通資訊,幸運的是,現在有很多可以用于做代碼評審的工具,包括商業的和免費的,

  另外,我想再做一些補充,對設計的評審應該基于設計檔案,在代碼評審階段去評審設計將會是低效的并且需要花費巨大的溝通成本,當然如果在代碼評審階段發現了設計的問題,需要回過頭去重新修改&評審設計檔案,

  綜上所述,輕量級的代碼評審對于業界大部分的軟體開發組織都是一個很好的選擇,是否在內部建立起正面的評審文化常常起決定性的作用,根據我的觀察,是否進行有效的代碼評審也基本上是區分二流軟體開發組織和三流軟體開發組織的一個明顯標志:)

 

轉載請註明出處,本文鏈接:https://www.uj5u.com/gongcheng/981.html

標籤:其他

上一篇:utools讓你3步搭建一個內網穿透工具

下一篇:TestLink使用指南

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • Git本地庫既關聯GitHub又關聯Gitee

    創建代碼倉庫 使用gitee舉例(github和gitee差不多) 1.在gitee右上角點擊+,選擇新建倉庫 ? 2.選擇填寫倉庫資訊,然后進行創建 ? 3.服務端已經準備好了,本地開始作準備 (1)Git 全域設定 git config --global user.name "成鈺" git c ......

    uj5u.com 2020-09-10 05:04:14 more
  • CODING DevOps 代碼質量實戰系列第二課,相約周三

    隨著 ToB(企業服務)的興起和 ToC(消費互聯網)產品進入成熟期,線上故障帶來的損失越來越大,代碼質量越來越重要,而「質量內建」正是 DevOps 核心理念之一。**《DevOps 代碼質量實戰(PHP 版)》**為 CODING DevOps 代碼質量實戰系列的第二課,同時也是本系列的 PHP ......

    uj5u.com 2020-09-10 05:07:43 more
  • 推薦Scrum書籍

    推薦Scrum書籍 直接上干貨,推薦書籍清單如下(推薦有順序的哦) Scrum指南 Scrum精髓 Scrum敏捷軟體開發 Scrum捷徑 硝煙中的Scrum和XP : 我們如何實施Scrum 敏捷軟體開發:Scrum實戰指南 Scrum要素 大規模Scrum:大規模敏捷組織的設計 用戶故事地圖 用 ......

    uj5u.com 2020-09-10 05:07:45 more
  • CODING DevOps 代碼質量實戰系列最后一課,周四發車

    隨著 ToB(企業服務)的興起和 ToC(消費互聯網)產品進入成熟期,線上故障帶來的損失越來越大,代碼質量越來越重要,而「質量內建」正是 DevOps 核心理念之一。 **《DevOps 代碼質量實戰(Java 版)》**為 CODING DevOps 代碼質量實戰系列的最后一課,同時也是本系列的 ......

    uj5u.com 2020-09-10 05:07:52 more
  • 敏捷軟體工程實踐書籍

    Scrum轉型想要做好,第一步先了解并真正落實Scrum,那么我推薦的Scrum書籍是要看懂并實踐的。第二步是團隊的工程實踐要做扎實。 下面推薦工程實踐書單: 重構:改善既有代碼的設計 決議極限編程 : 擁抱變化 代碼整潔代碼 程式員的職業素養 修改代碼的藝術 撰寫可讀代碼的藝術 測驗驅動開發 : ......

    uj5u.com 2020-09-10 05:07:55 more
  • Jenkins+svn+nginx實作windows環境自動部署vue前端專案

    前面文章介紹了Jenkins+svn+tomcat實作自動化部署,現在終于有空抽時間出來寫下Jenkins+svn+nginx實作自動部署vue前端專案。 jenkins的安裝和配置已經在前面文章進行介紹,下面介紹實作vue前端專案需要進行的哪些額外的步驟。 注意:在安裝jenkins和nginx的 ......

    uj5u.com 2020-09-10 05:08:49 more
  • CODING DevOps 微服務專案實戰系列第一課,明天等你

    CODING DevOps 微服務專案實戰系列第一課**《DevOps 微服務專案實戰:DevOps 初體驗》**將由 CODING DevOps 開發工程師 王寬老師 向大家介紹 DevOps 的基本理念,并探討為什么現代開發活動需要 DevOps,同時將以 eShopOnContainers 項 ......

    uj5u.com 2020-09-10 05:09:14 more
  • CODING DevOps 微服務專案實戰系列第二課來啦!

    近年來,工程專案的結構越來越復雜,需要接入合適的持續集成流水線形式,才能滿足更多變的需求,那么如何優雅地使用 CI 能力提升生產效率呢?CODING DevOps 微服務專案實戰系列第二課 《DevOps 微服務專案實戰:CI 進階用法》 將由 CODING DevOps 全堆疊工程師 何晨哲老師 向 ......

    uj5u.com 2020-09-10 05:09:33 more
  • CODING DevOps 微服務專案實戰系列最后一課,周四開講!

    隨著軟體工程越來越復雜化,如何在 Kubernetes 集群進行灰度發布成為了生產部署的”必修課“,而如何實作安全可控、自動化的灰度發布也成為了持續部署重點關注的問題。CODING DevOps 微服務專案實戰系列最后一課:**《DevOps 微服務專案實戰:基于 Nginx-ingress 的自動 ......

    uj5u.com 2020-09-10 05:10:00 more
  • CODING 儀表盤功能正式推出,實作作業資料可視化!

    CODING 儀表盤功能現已正式推出!該功能旨在用一張張統計卡片的形式,統計并展示使用 CODING 中所產生的資料。這意味著無需額外的設定,就可以收集歸納寶貴的作業資料并予之量化分析。這些海量的資料皆會以圖表或串列的方式躍然紙上,方便團隊成員隨時查看各專案的進度、狀態和指標,云端協作迎來真正意義上 ......

    uj5u.com 2020-09-10 05:11:01 more
最新发布
  • windows系統git使用ssh方式和gitee/github進行同步

    使用git來clone專案有兩種方式:HTTPS和SSH:
    HTTPS:不管是誰,拿到url隨便clone,但是在push的時候需要驗證用戶名和密碼;
    SSH:clone的專案你必須是擁有者或者管理員,而且需要在clone前添加SSH Key。SSH 在push的時候,是不需要輸入用戶名的,如果配置... ......

    uj5u.com 2023-04-19 08:41:12 more
  • windows系統git使用ssh方式和gitee/github進行同步

    使用git來clone專案有兩種方式:HTTPS和SSH:
    HTTPS:不管是誰,拿到url隨便clone,但是在push的時候需要驗證用戶名和密碼;
    SSH:clone的專案你必須是擁有者或者管理員,而且需要在clone前添加SSH Key。SSH 在push的時候,是不需要輸入用戶名的,如果配置... ......

    uj5u.com 2023-04-19 08:35:34 more
  • 2023年農牧行業6大CRM系統、5大場景盤點

    在物聯網、大資料、云計算、人工智能、自動化技術等現代資訊技術蓬勃發展與逐步成熟的背景下,數字化正成為農牧行業供給側結構性變革與高質量發展的核心驅動因素。因此,改造和提升傳統農牧業、開拓創新現代智慧農牧業,加快推進農牧業的現代化、資訊化、數字化建設已成為農牧業發展的重要方向。 當下,企業數字化轉型已經 ......

    uj5u.com 2023-04-18 08:05:44 more
  • 2023年農牧行業6大CRM系統、5大場景盤點

    在物聯網、大資料、云計算、人工智能、自動化技術等現代資訊技術蓬勃發展與逐步成熟的背景下,數字化正成為農牧行業供給側結構性變革與高質量發展的核心驅動因素。因此,改造和提升傳統農牧業、開拓創新現代智慧農牧業,加快推進農牧業的現代化、資訊化、數字化建設已成為農牧業發展的重要方向。 當下,企業數字化轉型已經 ......

    uj5u.com 2023-04-18 08:00:18 more
  • 計算機組成原理—存盤器

    計算機組成原理—硬體結構 二、存盤器 1.概述 存盤器是計算機系統中的記憶設備,用來存放程式和資料 1.1存盤器的層次結構 快取-主存層次主要解決CPU和主存速度不匹配的問題,速度接近快取 主存-輔存層次主要解決存盤系統的容量問題,容量接近與價位接近于主存 2.主存盤器 2.1概述 主存與CPU的聯 ......

    uj5u.com 2023-04-17 08:20:31 more
  • 談一談我對協同開發的一些認識

    如今各互聯網公司普通都使用敏捷開發,采用小步快跑的形式來進行專案開發。如果是小專案或者小需求,那一個開發可能就搞定了。但對于電商等復雜的系統,其功能多,結構復雜,一個人肯定是搞不定的,所以都是很多人來共同開發維護。以我曾經待過的商城團隊為例,光是后端開發就有七十多人。 為了更好地開發這類大型系統,往 ......

    uj5u.com 2023-04-17 08:18:55 more
  • 專案管理PRINCE2核心知識點整理

    PRINCE2,即 PRoject IN Controlled Environment(受控環境中的專案)是一種結構化的專案管理方法論,由英國政府內閣商務部(OGC)推出,是英國專案管理標準。
    PRINCE2 作為一種開放的方法論,是一套結構化的專案管理流程,描述了如何以一種邏輯性的、有組織的方法,... ......

    uj5u.com 2023-04-17 08:18:51 more
  • 談一談我對協同開發的一些認識

    如今各互聯網公司普通都使用敏捷開發,采用小步快跑的形式來進行專案開發。如果是小專案或者小需求,那一個開發可能就搞定了。但對于電商等復雜的系統,其功能多,結構復雜,一個人肯定是搞不定的,所以都是很多人來共同開發維護。以我曾經待過的商城團隊為例,光是后端開發就有七十多人。 為了更好地開發這類大型系統,往 ......

    uj5u.com 2023-04-17 08:18:00 more
  • 專案管理PRINCE2核心知識點整理

    PRINCE2,即 PRoject IN Controlled Environment(受控環境中的專案)是一種結構化的專案管理方法論,由英國政府內閣商務部(OGC)推出,是英國專案管理標準。
    PRINCE2 作為一種開放的方法論,是一套結構化的專案管理流程,描述了如何以一種邏輯性的、有組織的方法,... ......

    uj5u.com 2023-04-17 08:17:55 more
  • 計算機組成原理—存盤器

    計算機組成原理—硬體結構 二、存盤器 1.概述 存盤器是計算機系統中的記憶設備,用來存放程式和資料 1.1存盤器的層次結構 快取-主存層次主要解決CPU和主存速度不匹配的問題,速度接近快取 主存-輔存層次主要解決存盤系統的容量問題,容量接近與價位接近于主存 2.主存盤器 2.1概述 主存與CPU的聯 ......

    uj5u.com 2023-04-17 08:12:06 more