如何寫好 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被添加的原因
先來看看一個比較好的例子,感受一下:
下面談?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格式要求
延伸閱讀
- ssh框架 2016-09-30
- 阿里移動安全 [無線安全]玩轉(zhuǎn)無線電——不安全的藍(lán)牙鎖 2017-07-26
- 消息隊列NetMQ 原理分析4-Socket、Session、Option和Pipe 2024-03-26
- Selective Search for Object Recognition 論文筆記【圖片目標(biāo)分割】 2017-07-26
- 詞向量-LRWE模型-更好地識別反義詞同義詞 2017-07-26
- 從棧不平衡問題 理解 calling convention 2017-07-26
- php imagemagick 處理 圖片剪切、壓縮、合并、插入文本、背景色透明 2017-07-26
- Swift實現(xiàn)JSON轉(zhuǎn)Model - HandyJSON使用講解 2017-07-26
- 阿里移動安全 Android端惡意鎖屏勒索應(yīng)用分析 2017-07-26
- 集合結(jié)合數(shù)據(jù)結(jié)構(gòu)來看看(二) 2017-07-26