大主宰,女强穿越玄幻完结小说

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營(yíng)銷解決方案

80%的程序員，不會(huì)寫Commit記錄

本文轉(zhuǎn)載自微信公眾號(hào)「小姐姐味道」，作者小姐姐養(yǎng)的狗02號(hào)。轉(zhuǎn)載本文請(qǐng)聯(lián)系小姐姐味道公眾號(hào)。

據(jù)說(shuō)，80%的程序員，不會(huì)寫commit記錄。這個(gè)比例在無(wú)規(guī)范的小公司，比例會(huì)更高一些，可以看到這是一個(gè)多么普遍的問(wèn)題。

程序員應(yīng)該寫出簡(jiǎn)潔明了的commit log，否則對(duì)別人和自己來(lái)說(shuō)就是一種困擾。最近代碼review多了，總有一股想笑的感覺(jué)。就像下圖這滿屏的ok，永遠(yuǎn)無(wú)法從中得知提交人的意圖。

commit log將如何提交?都有哪些約定?其實(shí)是有答案的。對(duì)于Java程序員，尤其幸福。IDEA有一個(gè)非常好用的插件，可以用來(lái)輔助你進(jìn)行代碼提交，輔助你進(jìn)行團(tuán)隊(duì)規(guī)范建設(shè)。接下來(lái)，我將帶大家看一看它的使用方法。

安裝插件

在IDEA的Marketplace中，搜索Git Commit Template，就可以安裝這個(gè)插件。插件很小，很快就能下載下來(lái)。

正常從IDEA提交代碼的時(shí)候。我們發(fā)現(xiàn)多了一個(gè)小按鈕。

點(diǎn)擊之后，將彈出一個(gè)窗口。讓你去設(shè)計(jì)提交模板。

這么多信息，真的讓人頭暈。怪不得程序員們都不喜歡寫提交記錄。

其實(shí)，在插件的安裝界面，就已經(jīng)說(shuō)明了這個(gè)提交記錄的格式。

():

從描述中，可以肯容易的看到一個(gè)提交記錄中，應(yīng)該包含哪些東西。其中類型最多的，當(dāng)然是提交類型。

提交類型Type

我們按照插件顯示的順序來(lái)說(shuō)明一下。

feat 功能feature的意思，也是最常用的。當(dāng)你的功能有變更的時(shí)候，都可以采用這種類型的type
fix 當(dāng)然指的是bug修復(fù)
docs 更新了文檔，或者更新了注釋
style 代碼格式調(diào)整，比如執(zhí)行了format、更改了tab顯示等
refactor 重構(gòu)代碼。指的是代碼結(jié)構(gòu)的調(diào)整，比如使用了一些設(shè)計(jì)模式重新組織了代碼
perf 對(duì)項(xiàng)目或者模塊進(jìn)行了性能優(yōu)化。比如一些jvm的參數(shù)改動(dòng)，把stringbuffer改為stringbuilder等
test 這個(gè)簡(jiǎn)單，就是增加了單元測(cè)試和自動(dòng)化相關(guān)的代碼
build 影響編譯的一些更改，比如更改了maven插件、增加了npm的過(guò)程等
ci 持續(xù)集成方面的更改?，F(xiàn)在有些build系統(tǒng)喜歡把ci功能使用yml描述。如有這種更改，建議使用ci
chore 其他改動(dòng)。比如一些注釋修改或者文件清理。不影響src和test代碼文件的，都可以放在這里
revert 回滾了一些前面的代碼

除了這些預(yù)設(shè)的，團(tuán)隊(duì)還可以按照自己的需求，增加新的type。比如專門處理線上工單，就可以創(chuàng)造一個(gè)叫做ticket的類型。

范圍scope

scope是范圍的意思，主要指的是代碼的影響面。scope并沒(méi)有要求強(qiáng)制，但團(tuán)隊(duì)可以按照自己的理解進(jìn)行設(shè)計(jì)。通常由技術(shù)維度和業(yè)務(wù)維度兩種劃分方式。比如按照技術(shù)分為：controller、dto、service、dao等。但因?yàn)橐粋€(gè)功能提交，會(huì)涉及到多個(gè)scope(都不喜歡非常細(xì)粒度的提交)，所以按照技術(shù)維度分的情況比較少。

按照業(yè)務(wù)模塊進(jìn)行劃分，也是比較不錯(cuò)的選擇。比如分為user、order等劃分，可以很容易看出是影響用戶模塊還是order模塊。

如果你實(shí)在不知道怎么填，那就留空。

其他

主題subject

這個(gè)體現(xiàn)的是總結(jié)概括能力，沒(méi)得跑。一句話能夠說(shuō)明主要的提交是什么。subject也是眾多git管理工具默認(rèn)顯示的一行。如果你寫的標(biāo)準(zhǔn)，那么提交記錄看起來(lái)就很漂亮很規(guī)整。

正文Body

主要填寫詳細(xì)的改動(dòng)記錄。我一般習(xí)慣列上1234，但如果你的subject寫的非常好，正文可以直接弱化。但如果時(shí)間充裕，填寫上重要記錄的前因后果，需求背景，是一個(gè)好的習(xí)慣。

尾部Footer

添加一些額外的hook，比如提交記錄之后，自動(dòng)關(guān)閉jira的工單(JIRA和gitlab等是可以聯(lián)動(dòng)的)。在比如觸發(fā)一些文檔編譯或者其他動(dòng)作。

這部分自定義行也是比較強(qiáng)的。

Skip CI

最后還有一個(gè)skip CI選項(xiàng)。一般的ci工具，都可以設(shè)置提交代碼時(shí)自動(dòng)觸發(fā)編譯。但你可以告訴它忽略本次提交。這可能是因?yàn)槟闾崆邦A(yù)判到了一些構(gòu)建風(fēng)險(xiǎn)，或者就是不想編譯。

End

最后，看一個(gè)典型的提交記錄，有了工具的支持，我們的瞎扯也看得正經(jīng)起來(lái)。

  
 
 
    
  
  
  fix(order): 修復(fù)了1分錢買汽車的bug    
  
  
      
  
  
  商務(wù)反饋可以1分錢買汽車，目前已經(jīng)賣出了100w量    
  
  
      
  
  
  Closes #2455    
  
  
      
  
  
  [skip ci]

其實(shí)，提交的核心是type和subject。一個(gè)用來(lái)表示它的提交類型，一個(gè)用來(lái)對(duì)提交進(jìn)行概括性總結(jié)，寫好了這兩點(diǎn)，就能輕輕松松秒殺80%的程序員了。

有了這些基礎(chǔ)，從commit log，自動(dòng)生成change log，就變的非常的容易。配合持續(xù)集成平臺(tái)，自動(dòng)生成發(fā)版的變更記錄，也是可行的，這也是為什么團(tuán)隊(duì)管理，都在一直強(qiáng)調(diào)git的提交規(guī)范。因?yàn)樗_實(shí)非常有用。

作者簡(jiǎn)介：小姐姐味道 (xjjdog)，一個(gè)不允許程序員走彎路的公眾號(hào)。聚焦基礎(chǔ)架構(gòu)和Linux。十年架構(gòu)，日百億流量，與你探討高并發(fā)世界，給你不一樣的味道。我的個(gè)人微信xjjdog0，歡迎添加好友，進(jìn)一步交流。

分享題目：80%的程序員，不會(huì)寫Commit記錄
本文路徑：http://m.fisionsoft.com.cn/article/djoosgd.html

新聞中心

其他資訊