主頁 > 軟體工程 > CODING DevOps 代碼質量實戰系列第一課:代碼規范與 Git Flow

CODING DevOps 代碼質量實戰系列第一課:代碼規范與 Git Flow

2020-09-10 05:12:02 軟體工程

1

講師介紹

楊周
CODING DevOps 架構師
CODING 布道師

連續創業者、DIY/Linux 玩家、知乎小 V,曾在創新工場、百度擔任后端開發,十余年一線研發和帶隊經驗,經歷了 ToB、ToC、O2O、國內、出海各種專案,見證了云計算時代的誕生,擅長研發最佳實踐:Code Review、DevOps、Git Workflow、敏捷開發、架構、極客辦公硬體,

背景

隨著 ToB(企業服務)的興起和 ToC(消費互聯網)產品進入成熟期,線上故障帶來的損失越來越大,代碼質量越來越重要,而「質量內建」正是 DevOps 核心理念之一,而且提高代碼質量的最佳實踐,不只適合新專案,也為老專案提供完善的漸進式方案,

常見代碼質量問題

  • 英語拼寫錯誤
  • 泄露密碼
  • 無效注釋
  • 魔法數字
  • hard code(寫死)
  • 縮進等代碼風格問題

如何解決代碼質量問題

Code Review

第一步是鎖定主干,禁止直接提交,采用多分支開發,先拉取一個分支,修改代碼并推送分支,然后發起一個合并請求,請同事進行代碼評審了,比較高級的技巧是推代碼時自動創建一個合并請求,合并后臨時分支被自動洗掉,

創建合并請求后,需要把鏈接發給同事進行評審,這也是敏捷開發倡導的一個理念——高效溝通,一般選擇直接通過企業聊天工具通知同事,如果不及時通知,可能同事好幾天才會看到,耽誤專案進度,收到合并請求后,請盡量做到當天評審,不要拖延,

需要注意每次提交代碼只提交最小粒度的一件事,即「原子性提交」,而不要把幾件事做完一次性提交,比如有三件事,其中一件是修 Bug,結果修的有問題要回滾,如果三件事分三次提交,就可以輕松回滾有問題的,另外兩個正確的不受影響;而一起提交的話就沒法回滾,

Code Review 一定是在每次代碼合并進去之前進行評審,發現問題減少故障,如果錯誤的代碼已經合并上線了,這個時候再看就叫「故障反思會」而不叫「Code Review」,就沒有意義了,

2

Lint 代碼規范的增量檢查

Lint 叫代碼靜態掃描程式,各種語言對應的 Lint 程式是不同的,對應的規范也不同:

3

  • Lint 的使用時機

1、在 IDE 里實時運行,邊寫邊檢查,這樣是最方便的,缺點是需要每個人都進行配置,

2、Git commit 提交代碼時檢查:每個 Git 專案都有 .git/hooks 目錄,修改里面的 pre-commit 腳本,即可在提交代碼時進行攔截檢查,缺點是可被洗掉,

3、最可靠的就是服務端檢查,當代碼推送到服務器上時,進行持續集成檢查,這種方式非常可靠且不會被洗掉,缺點就是不如本地那么及時,

這三種方式一般結合使用,

4

  • 增量檢查

老專案的規范問題往往很多,一次清理干凈需要耗費大量人力,而且一次改動的代碼越多,風險就越高,可能導致線上故障,尤其是缺乏自動化測驗的專案,

所以建議使用增量檢查,如果同學們對 git 命令熟悉的話就很好理解,增量檢查就是 git diff,在本地提交時 git diff 可以拿到所有新增的、修改的和洗掉的檔案,只要把洗掉的檔案排除掉,把別的檔案挑出來,傳遞給 lint 程式就可以了,同學們一定要熟悉 Linux 命令、git 命令,不要一直用 git 的圖形界面,那你就很難掌握這些內容,

訪問 CODING 幫助檔案( https://help.coding.net/ ),搜索「增量檢查」,即可看到完整的配置代碼,

Git workflow

5

單兵作戰的時代就如上圖所示,一個人提交代碼,不需要什么作業流,一直往主干里提交就可以,而現在多人協作做專案時,每個人都往主干里提交就會產生沖突,如下圖所示,多分支開發,每個需求每個 Bug 都拉一個小分支,開發完畢再合并進主干里,

有兩種常用的作業流,第一種最簡單叫:Feature branch workflow(需求分支作業流),可以從下圖中看到主分支里拉下來兩個分支,一個做登錄,一個做支付,登錄做完就合并進去,后續有個短信的 bug 修復了,也合并進去后就發布了,但支付功能還在開發,這時就會出現問題,本來登錄和支付要一起上線,表示同一時期同一階段的兩個功能相互有依賴,結果因為線上的短信 bug 修復,就把登錄先帶上線了,這就導致了問題,所以大專案不適合用這種模式,而是使用第二種,

6

簡易 Git Flow 是雙分支的開發模式,除主分支外還有一個 develop 分支,Develop 分支對應敏捷開發里的迭代,每次迭代都會創建一個 develop,這次迭代里的所有功能開發完都合并到 develop,而不會合到主干上,主干保持隨時可發布的狀態,有 Bug 就在主干上修,等這次迭代全部結束,再把 develop 合到主干上,

Fork

Fork 不是作業流,團隊協作一定不要用 Fork,Fork是專門用于開源專案的,當我們試圖修改開源專案時,由于沒有創建分支的權限,只能把這個專案復刻(官方翻譯)成為自己的專案,然后再在自己的專案里拉分支,修改代碼,最后發起一個跨專案的合并請求,合并到作者的開源專案里,如果后面還想再開發的話,需要再同步過來,所以 Fork 僅僅用于開源協作,完全不適合團隊協作,同學們千萬不要搞錯,具體的檔案可以掃碼進行查看,

7

結語

最后總結一下代碼質量的升級路線,從最原始的提交主干不檢查代碼,不檢查規范,到鎖定主干進行人工檢查,然后人工檢查太累,希望能做自動檢查,把盡量多的東西都做成自動檢查,但有些東西是自動檢查做不了的,比如代碼里使用了拼音,語法沒有報錯;或者英文單詞用錯,比如用戶的「積分」應該使用points 而不是integral,所以不能看見自動化檢查過了,就直接同意合并,這是不負責任的做法,一定要進行人工檢查,

經過這個流程,同學們的代碼就會非常干凈漂亮,團隊協作的風格也一致了,一般會挑一個知名的業界大廠的代碼規范,而不要自己發明規范,這樣不僅不能服眾,而且以后再參加開源專案的話,難以和業界保持一致,

點擊觀看課程回放

關于 CODING,了解更多

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

標籤:其他

上一篇:CODING 儀表盤功能正式推出,實作作業資料可視化!

下一篇:CODING DevOps 代碼質量實戰系列第二課: PHP 版

標籤雲
其他(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