Java?Git?Commit?Message使用規(guī)范
概述
不知道大家在各自項目中是如何寫提供代碼的commit message, 我們項目有的同事寫的很簡單,壓根不知道提交了什么內(nèi)容,是新功能還是缺陷修復(fù)。本質(zhì)上 commit message就是為了讓團隊成員知道這次提交的內(nèi)容,為此,我們出了一個規(guī)范,約定團隊的每個同事按照這個規(guī)范提交代碼,達到通過message能夠了解此次修改的內(nèi)容。
一、Commit message 的格式
每次提交,Commit message 都包括三個部分:Header,Body 和 Footer。
<type>(<scope>): <subject> // 空一行 <body>
其中,Header、針對feat和fix類型的提交內(nèi)容 Body 是必需的。 不管是哪一個部分,任何一行都不得超過72個字符(或100個字符)。這是為了避免自動換行影響美觀。
1.1 Header
Header部分只有一行,包括三個字段: type(必需)、scope(必需)和subject(必需)。
(1)type
type用于說明 commit 的類別,只允許使用下面7個標識。
- feat:新功能(feature)
- fix:修補bug
- docs:文檔(documentation)
- style: 格式(不影響代碼運行的變動)
- refactor:重構(gòu)(即不是新增功能,也不是修改bug的代碼變動)
- test:增加測試
- build:構(gòu)建過程或輔助工具的變動
(2)scope
scope用于說明 commit 影響的范圍,比如指標模板、規(guī)則上下線等等,視項目不同而不同。
(3)subject
subject是 commit 目的的簡短描述,不超過50個字符。
- 1. 以動詞開頭,使用第一人稱現(xiàn)在時,比如change,而不是changed或changes
- 2. 第一個字母小寫
- 3. 結(jié)尾不加句號(.)
1.2 Body
Body 部分是對本次 commit 的詳細描述,可以分成多行。
- 1. 需要簡要的列出各種正向或者反向的測試場景,測試通過,填pass。
- 2. 增加修改人信息
二、例子
2.1 feat例子
feat(規(guī)則上下線、構(gòu)建、生效、仿真生效): 添加規(guī)則上下線功能
1. 規(guī)則上下線主流程,引擎正常訂閱,fldl生成正常。 pass
2. 規(guī)則上下線,傳入不存在的規(guī)則編號,異常提示。 pass提交人:xxx
2.2 fix例子
fix(模型模塊): 模型測試失敗
1. 導(dǎo)入mar模型,包含衍生字段。 pass
2. 導(dǎo)入mar模型,不包含衍生字段。 pass提交人:xxx
插件推薦
idea可以安裝代碼提交規(guī)范的插件。
1.安裝插件

2.提交時選擇插件提交


到此這篇關(guān)于Java Git Commit Message使用規(guī)范的文章就介紹到這了,更多相關(guān)Java Git Commit Message內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
手把手教你如何利用SpringBoot實現(xiàn)審核功能
審核功能經(jīng)過幾個小時的奮戰(zhàn)終于完成了,現(xiàn)在我就與廣大網(wǎng)友分享我的成果,這篇文章主要給大家介紹了關(guān)于如何利用SpringBoot實現(xiàn)審核功能的相關(guān)資料,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下2023-05-05
Springboot整合Redis實現(xiàn)超賣問題還原和流程分析(分布式鎖)
最近在研究超賣的項目,寫一段簡單正常的超賣邏輯代碼,多個用戶同時操作同一段數(shù)據(jù)出現(xiàn)問題,糾結(jié)該如何處理呢?下面小編給大家?guī)砹薙pringboot整合Redis實現(xiàn)超賣問題還原和流程分析,感興趣的朋友一起看看吧2021-10-10
Java畢業(yè)設(shè)計實戰(zhàn)之校園一卡通系統(tǒng)的實現(xiàn)
這是一個使用了java+Springboot+Maven+mybatis+Vue+mysql+wd開發(fā)的校園一卡通系統(tǒng),是一個畢業(yè)設(shè)計的實戰(zhàn)練習(xí),具有校園一卡通系統(tǒng)該有的所有功能,感興趣的朋友快來看看吧2022-01-01
Java class文件格式之方法_動力節(jié)點Java學(xué)院整理
這篇文章主要為大家詳細介紹了Java class文件格式之方法的相關(guān)資料,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-06-06
Spring Cloud Alibaba Nacos Config進階使用
這篇文章主要介紹了Spring Cloud Alibaba Nacos Config進階使用,文中使用企業(yè)案例,圖文并茂的展示了Nacos Config的使用,感興趣的小伙伴可以看一看2021-08-08

