1. 程式人生 > 程式設計 >vue-cli建立的專案中的gitHooks原理解析

vue-cli建立的專案中的gitHooks原理解析

前言

在使用 vue create my-app 建立專案的時候,Vue 會自動幫我們做好一些預配置,你可以不使用它,但是一旦需要的時候,突然發現,咦~原來它已經幫我做好準備工作了,只需要按自己的需求配置一下就可以了,就會覺得 vue-cli 很貼心啊,幫我們節省了很多時間。

package.json 檔案中會發現 gitHookslint-staged 等欄位,不難看出它是在我們執行 git 命令的時候會自動執行的一些額外的操作,比如語法提示、錯誤提示等。

這個完整的過程是怎樣的呢?

流程解析

yorkie 包

執行 vue create 命令的時候,會安裝一個包,叫: yorkie ,這個包是尤大 fork 自 husky 的,它倆功能是一樣的,都是生成一些 git hooks 檔案,讀取專案中 package.json

的相關配置項去執行一些命令,區別是尤大做了一些邏輯和配置上的改動。

安裝完這個包以後,會自動執行 yorkie 包裡面的一個指令碼: bin/install.js

vue-cli建立的專案中的gitHooks原理解析

這個指令碼會在你專案下的 .git/hooks 目錄中生成很多 git hooks 檔案:

vue-cli建立的專案中的gitHooks原理解析

當你執行一些 git 命令的時候,比如: git push,git commit 等,git 就會執行相應的 hook。

package.json

git commit -a -m'123' 這個命令為例子,執行這個命令的時候,git 會去執行 pre-commit 這個 hook。

先把 package.json 的相關內容貼出來,讓大家先有個印象:

"gitHooks": {
 "pre-commit": "lint-staged",},"lint-staged": {
 "*.{js,jsx,vue}": [
 "vue-cli-service lint","git add"
 ]
}

pre-commit hook

接下來我們看 pre-commit 的檔案內容:

##...
has_hook_script () {
 [ -f package.json ] && cat package.json | grep -q "\"$1\"[[:space:]]*:"
}
# 檢查 package.json 檔案中是否定義了 pre-commit
has_hook_script pre-commit || exit 0

# 執行 hook 
node "./node_modules/yorkie/src/runner.js" pre-commit || {
 echo
 echo "pre-commit hook failed (add --no-verify to bypass)"
 exit 1
}

可以看到 pre-commit 檔案去檢查了一下 package.json 檔案中是否定義了pre-commit,如果定義了,就執行 yorkie 的 runner.js 指令碼。

yorkie 的 runner.js 指令碼

我們繼續看 runner.js 指令碼的內容:

//...
const cwd = process.cwd()
const pkg = fs.readFileSync(path.join(cwd,'package.json'))
// 取到 package.json 裡面定義的 gitHooks 內容
const hooks = JSON.parse(pkg).gitHooks
if (!hooks) {
 process.exit(0)
}
// 從上文得知,這個值是 pre-commit
const hook = process.argv[2]
// 取 gitHooks 裡面定義的 pre-commit 的內容,也就取到:lint-staged
const command = hooks[hook]
if (!command) process.exit(0)
// 執行 lint-staged 命令
execa.shellSync(command,{ stdio: 'inherit' })

從這個過程中可以看到,當我們執行 git commit -a -m'123' 這個 git 命令的時候,git hook 執行了 yorkie 的一個指令碼去讀取了 package.json 檔案中的內容,取到相關的配置項,然後執行配置項中的命令。

在上述例子中,因為執行了 lint-staged 命令,它會讀取 package.json 中的 "lint-staged" 配置項,進而又繼續執行了 vue-cli-service lint 這個命令,整個執行的過程就像像鏈條一樣一環連著一環,直到所有命令都執行完畢。

實踐

明白了這個流程後,在專案中就可以根據需求靈活地做一些配置了,比如在執行 commit-msg hook 的時候加上 commitlint ,規範協作者提交的git 資訊,加上這個以後,執行之前的示例命令: git commit -a -m'123' 就會有提交資訊不規範的錯誤提示,根據提示改成: git commit -a -m'feat: 123' 就可以提交了。

同樣的,與 pre-commit 搭配使用的 lint-staged ,也可以加上一些命令,比如這裡加了 pretty-quick 用來統一程式碼格式。

示例:

"gitHooks": {
 "pre-commit": "lint-staged","commit-msg": "commitlint -E GIT_PARAMS"
},vue}": [
 "pretty-quick --staged","vue-cli-service lint","git add"
 ]
}

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援我們。