commitlint+husky規(guī)范git commit日志

本文從淺入深的介紹整個commitlint+husky規(guī)范commit日志的使用,先介紹如何時候,最后部分講解原理梭域。

為什么需要規(guī)范commit日志?

1搅轿、commit message 是程序員開發(fā)的日常操作, 但是實(shí)際工作中卻常常被大家忽略

2病涨、目前commit message 處于五花八門的書寫風(fēng)格,十分不利于閱讀和維護(hù)

3璧坟、優(yōu)秀的互聯(lián)網(wǎng)科技公司都有一套代碼提交規(guī)范既穆,尤其是在一些大型開源項(xiàng)目中,commit message 都是十分一致

規(guī)范commit日志的好處

1雀鹃、團(tuán)隊(duì)形成一致的代碼提交風(fēng)格幻工,更好的提高工作效率

2、規(guī)范的 commit message 有助于團(tuán)隊(duì)其它人員 review, 還可以有效的輸出 CHANGELOG, 對項(xiàng)目十分重要

3黎茎、成為一名有追求的工程師

安裝步驟

1囊颅、環(huán)境準(zhǔn)備:安裝node環(huán)境,從Node.js官網(wǎng)(https://nodejs.org/en/)下載對應(yīng)平臺的安裝程序,終端執(zhí)行命令 node -v 和 npm -v 可以查看安裝的node踢代,npm的版本號盲憎,出現(xiàn)如下即成功。


2胳挎、commitlint饼疙、husky安裝

步驟一:創(chuàng)建默認(rèn)package.json文件、進(jìn)入項(xiàng)目目錄慕爬,右鍵git bash here宏多,運(yùn)行命令:npm init -y,澡罚,此時項(xiàng)目目錄就出現(xiàn)了package.json文件伸但。

步驟二:初始化package.json文件內(nèi)容,運(yùn)行命令:npm init留搔,按照提示輸入內(nèi)容即可,生成如下內(nèi)容更胖。

{

? "name": "commitlint-husky",

? "version": "1.0.0",

? "description": "commitlint",

? "main": "index.js",

? "directories": {

? ? "doc": "doc"

? },

? "scripts": {

? ? "test": "echo \"Error: no test specified\" && exit 1"

? },

? "repository": {

? ? "type": "git",

? ? "url": "http://10.10.8.201/caxs/caxs-artemis.git"

? },

? "keywords": [],

? "author": "geekspring",

? "license": "ISC",

步驟三:安裝commitlint插件

命令:

npm install --save-dev @commitlint/cli?@commitlint/onfigconventional?@commitlint/config-angular

步驟四:安裝husky

命令:npm install --save-dev husky

在package.json中添加husky

"husky": {

? ? "hooks": {

? ? ? "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"

? ? }

? }

步驟五:安裝changelog插件,方便查看changlog日志文件

命令:npm install --save-dev?conventional-changelog-cli

在package.json文件中添加changlog命令隔显,方便查看

"scripts": {

? ? "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s"

? }

到此就安裝完畢啦却妨。

規(guī)則使用

方式一:使用angular團(tuán)隊(duì)的規(guī)則,在項(xiàng)目目錄下創(chuàng)建commitlint.config.js文件括眠,加入如下配置即可:

module.exports = {extends: ['@commitlint/config-angular']};

方式二:自定義規(guī)則文件內(nèi)容彪标,創(chuàng)建commitlint.config.js文件,加入如下配置:


rule配置說明:

rule由name和配置數(shù)組組成

1掷豺、數(shù)組中第一位為level捞烟,可選0,1,2,0為disable当船,1為warning题画,2為error

2、第二位為應(yīng)用與否德频,可選always|never

3苍息、第三位該rule的值

使用效果圖

錯誤示例:



正確示例:




查看changlog日志,根據(jù)配置的命令 npm??changelog

原理介紹

commitlin介紹

目前國內(nèi)外規(guī)范使用較多的是 Angular 團(tuán)隊(duì)的規(guī)范, 目前規(guī)范參考Angular 團(tuán)隊(duì)比較多壹置。直接看如下參考資料很詳細(xì)竞思。

參考資料:

https://blog.csdn.net/y550918116j/article/details/81214746

https://www.npmjs.com/package/@commitlint/config-angular

https://blog.csdn.net/peterxiaoq/article/details/76144288

husky介紹:

? ? ? husky 是一個為 git 客戶端增加 hook 的工具。

? ? ? 在.git/ 目錄下增加husky鉤子盖喷,在 pre-commit 階段自動執(zhí)行保證每一個 commit 的commit message的正確性

追根溯源:

git對提交的內(nèi)容會校驗(yàn),校驗(yàn)主要分為:

? ? 1患亿、 服務(wù)端pre-receive鉤子

? ? 2传蹈、客戶端的pre-commit鉤子

? ? 客戶端的pre-commit鉤子驗(yàn)證提高服務(wù)端的鉤子驗(yàn)證效率,可以理解為:

服務(wù)端的pre-receive鉤子:后端驗(yàn)證

客戶端的pre-commit鉤子:前端驗(yàn)證

前端驗(yàn)證的效率高于惦界,將所有的驗(yàn)證都放在后端,故此沾歪,在pre-commit處增加了husky鉤子

鉤子判斷壞的commit 會被拒絕在本地漂彤,本地只能將鉤子可以通過的代碼提交到中心倉庫。








最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末挫望,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子狂窑,更是在濱河造成了極大的恐慌,老刑警劉巖泉哈,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異丛晦,居然都是意外死亡奕纫,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進(jìn)店門烫沙,熙熙樓的掌柜王于貴愁眉苦臉地迎上來匹层,“玉大人,你說我怎么就攤上這事锌蓄∩ぃ” “怎么了?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵煤率,是天一觀的道長仰冠。 經(jīng)常有香客問我,道長蝶糯,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任辆沦,我火速辦了婚禮昼捍,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘肢扯。我一直安慰自己妒茬,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布蔚晨。 她就那樣靜靜地躺著乍钻,像睡著了一般肛循。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上银择,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天多糠,我揣著相機(jī)與錄音,去河邊找鬼浩考。 笑死夹孔,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的析孽。 我是一名探鬼主播搭伤,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼袜瞬!你這毒婦竟也來了怜俐?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤邓尤,失蹤者是張志新(化名)和其女友劉穎佑菩,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體裁赠,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡殿漠,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了佩捞。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片绞幌。...
    茶點(diǎn)故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖一忱,靈堂內(nèi)的尸體忽然破棺而出莲蜘,到底是詐尸還是另有隱情,我是刑警寧澤票渠,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站问顷,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏杜窄。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一塞耕、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧嘴瓤,春花似錦莉钙、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽蜀涨。三九已至,卻和暖如春厚柳,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背沐兵。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留扎谎,地道東北人。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓毁靶,卻偏偏與公主長得像,于是被迫代替她去往敵國和親预吆。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內(nèi)容

  • 原文鏈接 前言 在git的使用中拐叉,一種最佳實(shí)踐是使用格式化的commit信息,這樣方便自動化工具進(jìn)行處理凤瘦,可以快速...
    馮宇Ops閱讀 8,594評論 2 34
  • 前言 之前我寫過一篇有關(guān)于git提交的文檔《用gitmoji來提交你的git commit吧》,然而在實(shí)際上應(yīng)用并...
    mytac閱讀 2,433評論 2 3
  • 什么是 NPM npm之于Node梆靖,就像pip之于Python,gem之于Ruby,composer之于PHP。 ...
    ihoey閱讀 6,250評論 2 36
  • 一涤姊、前言 現(xiàn)在最流行的版本管理工具非git莫屬,而良好的代碼規(guī)范有助于項(xiàng)目的維護(hù)嗤放,為了防止一些不規(guī)范的代碼 co...
    前端妹子ice閱讀 52,703評論 2 17
  • 又是記錄水彩學(xué)習(xí)作業(yè)次酌,話說這幅畫還未畫完恨课,臨摹的過程也是錯誤不斷岳服,線稿過程慢,上色過程更慢吊宋,調(diào)色過程也是調(diào)的不像纲辽,...
    若魚愛畫畫閱讀 331評論 0 4