如何寫好 Git commit messages

導(dǎo)語:任何軟件項目都是一個協(xié)作項目,它至少需要2個開發(fā)人員參與,當(dāng)原始的開發(fā)人員將項目開發(fā)幾個星期或者幾個月之后,項目步入正規(guī)。不過他們或者后續(xù)的開發(fā)人員仍然需要經(jīng)常提交一些代碼去修復(fù)bug或者實現(xiàn)新的feature。我們經(jīng)常有這種感受:當(dāng)一個項目時間過了很久之后,我們對于項目里面的文件和函數(shù)功能漸漸淡忘,重新去閱讀熟悉這部分代碼是很浪費時間并且惱人的一件事。但是這也沒法完全避免,我們可以使用一些技巧盡可能減少重新熟悉代碼的時間。commit messages可以滿足需要,它也反映了一個開發(fā)人員是否是良好的協(xié)作者。

編寫良好的Commit messages可以達(dá)到3個重要的目的:

  • 加快review的流程

  • 幫助我們編寫良好的版本發(fā)布日志

  • 讓之后的維護(hù)者了解代碼里出現(xiàn)特定變化和feature被添加的原因

先來看看一個比較好的例子,感受一下:
seo優(yōu)化培訓(xùn),網(wǎng)絡(luò)推廣培訓(xùn),網(wǎng)絡(luò)營銷培訓(xùn),SEM培訓(xùn),網(wǎng)絡(luò)優(yōu)化,在線營銷培訓(xùn)

下面談?wù)劊绾巫岉椖坷锩娴腃ommit messages步入規(guī)范化,流程化。

Commit messages的基本語法

<type>: <subject><BLANK LINE><body><BLANK LINE><footer>

Type表示提交類別,Subject表示標(biāo)題行, Body表示主體描述內(nèi)容。

Type的類別說明:

  • feat: 添加新特性

  • fix: 修復(fù)bug

  • docs: 僅僅修改了文檔

  • style: 僅僅修改了空格、格式縮進(jìn)、都好等等,不改變代碼邏輯

  • refactor: 代碼重構(gòu),沒有加新功能或者修復(fù)bug

  • perf: 增加代碼進(jìn)行性能測試

  • test: 增加測試用例

  • chore: 改變構(gòu)建流程、或者增加依賴庫、工具等

Commit messages格式要求

        		

延伸閱讀

學(xué)習(xí)是年輕人改變自己的最好方式-Java培訓(xùn),做最負(fù)責(zé)任的教育,學(xué)習(xí)改變命運,軟件學(xué)習(xí),再就業(yè),大學(xué)生如何就業(yè),幫大學(xué)生找到好工作,lphotoshop培訓(xùn),電腦培訓(xùn),電腦維修培訓(xùn),移動軟件開發(fā)培訓(xùn),網(wǎng)站設(shè)計培訓(xùn),網(wǎng)站建設(shè)培訓(xùn)學(xué)習(xí)是年輕人改變自己的最好方式