Java?Git?Commit?Message使用規(guī)范
概述
不知道大家在各自項(xiàng)目中是如何寫(xiě)提供代碼的commit message, 我們項(xiàng)目有的同事寫(xiě)的很簡(jiǎn)單,壓根不知道提交了什么內(nèi)容,是新功能還是缺陷修復(fù)。本質(zhì)上 commit message就是為了讓團(tuán)隊(duì)成員知道這次提交的內(nèi)容,為此,我們出了一個(gè)規(guī)范,約定團(tuán)隊(duì)的每個(gè)同事按照這個(gè)規(guī)范提交代碼,達(dá)到通過(guò)message能夠了解此次修改的內(nèi)容。
一、Commit message 的格式
每次提交,Commit message 都包括三個(gè)部分:Header,Body 和 Footer。
<type>(<scope>): <subject> // 空一行 <body>
其中,Header、針對(duì)feat和fix類型的提交內(nèi)容 Body 是必需的。 不管是哪一個(gè)部分,任何一行都不得超過(guò)72個(gè)字符(或100個(gè)字符)。這是為了避免自動(dòng)換行影響美觀。
1.1 Header
Header部分只有一行,包括三個(gè)字段: type(必需)、scope(必需)和subject(必需)。
(1)type
type用于說(shuō)明 commit 的類別,只允許使用下面7個(gè)標(biāo)識(shí)。
- feat:新功能(feature)
- fix:修補(bǔ)bug
- docs:文檔(documentation)
- style: 格式(不影響代碼運(yùn)行的變動(dòng))
- refactor:重構(gòu)(即不是新增功能,也不是修改bug的代碼變動(dòng))
- test:增加測(cè)試
- build:構(gòu)建過(guò)程或輔助工具的變動(dòng)
(2)scope
scope用于說(shuō)明 commit 影響的范圍,比如指標(biāo)模板、規(guī)則上下線等等,視項(xiàng)目不同而不同。
(3)subject
subject是 commit 目的的簡(jiǎn)短描述,不超過(guò)50個(gè)字符。
- 1. 以動(dòng)詞開(kāi)頭,使用第一人稱現(xiàn)在時(shí),比如change,而不是changed或changes
- 2. 第一個(gè)字母小寫(xiě)
- 3. 結(jié)尾不加句號(hào)(.)
1.2 Body
Body 部分是對(duì)本次 commit 的詳細(xì)描述,可以分成多行。
- 1. 需要簡(jiǎn)要的列出各種正向或者反向的測(cè)試場(chǎng)景,測(cè)試通過(guò),填pass。
- 2. 增加修改人信息
二、例子
2.1 feat例子
feat(規(guī)則上下線、構(gòu)建、生效、仿真生效): 添加規(guī)則上下線功能
1. 規(guī)則上下線主流程,引擎正常訂閱,fldl生成正常。 pass
2. 規(guī)則上下線,傳入不存在的規(guī)則編號(hào),異常提示。 pass提交人:xxx
2.2 fix例子
fix(模型模塊): 模型測(cè)試失敗
1. 導(dǎo)入mar模型,包含衍生字段。 pass
2. 導(dǎo)入mar模型,不包含衍生字段。 pass提交人:xxx
插件推薦
idea可以安裝代碼提交規(guī)范的插件。
1.安裝插件
2.提交時(shí)選擇插件提交
到此這篇關(guān)于Java Git Commit Message使用規(guī)范的文章就介紹到這了,更多相關(guān)Java Git Commit Message內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Java8中使用流方式查詢數(shù)據(jù)庫(kù)的方法
這篇文章主要介紹了Java8中使用流方式查詢數(shù)據(jù)庫(kù)的相關(guān)資料,需要的朋友可以參考下2016-01-01Java讀取網(wǎng)絡(luò)文件的實(shí)例代碼
這篇文章主要介紹了Java讀取網(wǎng)絡(luò)文件的實(shí)例代碼,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-07-07手把手教你如何利用SpringBoot實(shí)現(xiàn)審核功能
審核功能經(jīng)過(guò)幾個(gè)小時(shí)的奮戰(zhàn)終于完成了,現(xiàn)在我就與廣大網(wǎng)友分享我的成果,這篇文章主要給大家介紹了關(guān)于如何利用SpringBoot實(shí)現(xiàn)審核功能的相關(guān)資料,文中通過(guò)實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2023-05-05Springboot整合Redis實(shí)現(xiàn)超賣(mài)問(wèn)題還原和流程分析(分布式鎖)
最近在研究超賣(mài)的項(xiàng)目,寫(xiě)一段簡(jiǎn)單正常的超賣(mài)邏輯代碼,多個(gè)用戶同時(shí)操作同一段數(shù)據(jù)出現(xiàn)問(wèn)題,糾結(jié)該如何處理呢?下面小編給大家?guī)?lái)了Springboot整合Redis實(shí)現(xiàn)超賣(mài)問(wèn)題還原和流程分析,感興趣的朋友一起看看吧2021-10-10Java畢業(yè)設(shè)計(jì)實(shí)戰(zhàn)之校園一卡通系統(tǒng)的實(shí)現(xiàn)
這是一個(gè)使用了java+Springboot+Maven+mybatis+Vue+mysql+wd開(kāi)發(fā)的校園一卡通系統(tǒng),是一個(gè)畢業(yè)設(shè)計(jì)的實(shí)戰(zhàn)練習(xí),具有校園一卡通系統(tǒng)該有的所有功能,感興趣的朋友快來(lái)看看吧2022-01-01maven打包zip包含bin下啟動(dòng)腳本的完整代碼
這篇文章主要介紹了maven打包zip包含bin下啟動(dòng)腳本,本文給大家講解的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2021-10-10Java class文件格式之方法_動(dòng)力節(jié)點(diǎn)Java學(xué)院整理
這篇文章主要為大家詳細(xì)介紹了Java class文件格式之方法的相關(guān)資料,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-06-06Spring Cloud Alibaba Nacos Config進(jìn)階使用
這篇文章主要介紹了Spring Cloud Alibaba Nacos Config進(jìn)階使用,文中使用企業(yè)案例,圖文并茂的展示了Nacos Config的使用,感興趣的小伙伴可以看一看2021-08-08SpringBoot中web模板渲染的實(shí)現(xiàn)
本文主要介紹了SpringBoot中web模板渲染的實(shí)現(xiàn),文中通過(guò)示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-02-02