如何利用git提交實現自動生成日志文件

如何利用git提交實現自動生成日志文件？很多新手對此不是很清楚，為了幫助大家解決這個難題，下面小編將為大家詳細講解，有這方面需求的人可以來學習下，希望你能有所收獲。

每次git提交信息的時候會先驗證提交的格式是否符合規范，符合規范并運行eslint
兩者都符合之后才可正常提交，并可以根據提交的信息自動生成日志信息。
一般是遵循 Angular Commit Message

校驗commit 格式

主要使用 @commitlint/cli @commitlint/config-conventional 來校驗commit是否符合規范 一般可以全局安裝or本地安裝

install

全局

npm install -g @commitlint/cli @commitlint/config-conventional

本地

npm install --save-dev @commitlint/cli @commitlint/config-conventional

如果是全局可以使用下面這條命令查看全局有沒有安裝成功

npm ls -g -depth=0

生成配置文件

在項目根目錄下運行下面這個命令生成對應的配置文件

touch commitlint.config.js

文件內容一般可以設置如下:

module.exports = {
 extends: ['@commitlint/config-conventional'],
 rules: {
  'type-enum': [2, 'always', [
   "feat", "fix", "docs", "style", "refactor", "test", "chore", "revert"
  ]],
  'subject-full-stop': [0, 'never'],
  'subject-case': [0, 'never']
 }
};

husky

一般校驗規則設置好之后會結合husky提供的鉤子，在每次commit之前會先去校驗，如果不符合校驗規則，則提交失敗
husky 繼承了git下所有的鉤子，需要注意在使用husky之前，先git init 一下，否則沒有 .git文件，就沒法繼承git的鉤子了
如果項目中刪除了.git 文件，那需要在git init之后重新安裝一下husky否則就不work了

install

npm install husky --save-dev

config

在package.json中添加配置

"husky": {
  "hooks": {
   "commit-msg": "commitlint -e $GIT_PARAMS"
  }
 }

至此，每次提交如果不符合規范就會提交失敗，類似下面這種提示

commitizen

一個輔助工具，可以讓我們寫出一個符合規范的commit信息。
通過交互式的命令，我們可以寫出符合規范的commit.可以全局安裝

install

npm install -g commitizen

安裝之后在需要使用git commit的地方使用git cz 代替，就會出現交互式命令行窗口，直接選擇對應的選項讓后填寫即可
如下：

lint-staged

這個工具好像和提交沒有太大關系，但一般也都會用到，所以這里順帶提一下，這個是每次提交的時候讓eslint只驗證自己這次所改動的代碼，對于其他代碼則不會去lint。
不至于每次提交都會對所有的文件呢lint.

install

npm i --save-dev lint-staged 

config

在package.json中配置下：

 "husky": {
  "hooks": {
   "pre-commit": "lint-staged",
   "commit-msg": "commitlint -e $HUSKY_GIT_PARAMS"
  }
 }

當然這里假定你的項目中有關eslint的其他配置都已近配置好了。也可以加上prettierrc去格式化代碼，這里就不加了
上面的配置會在每次提交之前對所改動的代碼進行lint

自動生成日志文件

主要使用到 conventional-changelog 工具來幫助我們自動生成日志文件

install

一般這種工具可以全局安裝一下比較方便

npm install -g conventional-changelog

只安裝上面的運行相關命令會報錯，安裝下對應的cli

npm install -g conventional-changelog-cli

同樣可以使用下面這條命令查看是否安裝成功

npm ls -g -depth=0

自動生成日志

沒問題之后在項目的根目錄下運行下列命令

conventional-changelog -p angular -i Changelog.md -s

當然也可以在package.json中配置成一個命令，這樣就很方便

"scripts": {
  "changelog": "conventional-changelog -p angular -i Changelog.md -s"
 },

這樣每次運行下面這條命令即可在項目根目錄自動生成對應的日志文件

npm run changelog

當然上述的changelog.md是生成的文件名，你也可以該成自己期望的文件名

總結

總結一下用這套工具容易出錯的幾個地方吧。

1.一個是使用husky之前需要git init一下，如果刪除了項目中的.git文件夾，雖然此時已近安裝過了husky，在重新git init之后依然需要重新安裝一下husky否則繼承不了git的鉤子，就不work

2.針對上面的第一條，有的時候按照套路來，可就是會發現會報一個這個錯誤
這個時候可以查看本地項目中 .git有木有hooks文件，如果沒有那說明husky沒有繼承git，如果有的話就rm -rf .git/hooks然后重新安裝下husky。這是一個closed issue

3，生成日志的時候也需要安裝 conventional-changelog-cli 否則會報一個命令找不到的錯誤.

看完上述內容是否對您有幫助呢？如果還想對相關知識有進一步的了解或閱讀更多相關文章，請關注億速云行業資訊頻道，感謝您對億速云的支持。