深入理解Babel - 項目管理工具Lerna解析
一、背景
Babel是一個比較龐大的項目，其子工程就有至少140個(如 babel/plugins/presets/lerna/babel-loader等)，產(chǎn)出的子工具已經(jīng)是前端開發(fā)的基礎(chǔ)設(shè)施，對開發(fā)效率、代碼質(zhì)量等有非常高的要求。
在本文中，我們將了解Babel是怎樣進行項目管理的。
圖片
本文從工程管理、代碼管理、文檔管理、質(zhì)量管理四個方面對Babel項目管理進行拆解分析。
工程管理
Babel是典型的monorepo項目，即單倉庫項目，所有的子模塊在同一個倉庫里。Babel目前有140+個子模塊，在工程管理部分，需要解決以下問題：
- 模塊間如何方便地互相關(guān)聯(lián)進行本地開發(fā)；
- 整個項目的版本控制；
- 操作自動化。
工程管理部分主要使用lerna、yarn等工具。
代碼風(fēng)格
Babel是多人協(xié)作開發(fā)的開源項目，如何保證代碼風(fēng)格一致，Babel使用的是社區(qū)常見的解決方案。
該模塊主要使用eslint、prettier等工具。
文檔
Babel的迭代速度很快、涉及的模塊很多，該模塊解決版本發(fā)布后如何自動更新相關(guān)文檔等問題。
該模塊主要使用lerna等工具。
質(zhì)量控制
Babel的產(chǎn)品是前端開發(fā)的基礎(chǔ)設(shè)施，該模塊主要保證Babel的產(chǎn)出是高質(zhì)量的。
該模塊主要使用jest、git blame等工具。
二、monorepo
Babel使用monorepo模式進行工程管理。
什么是monorepo
monorepo(monolithic repository)，指的是單倉庫代碼，將多個項目代碼存儲在一個倉庫里。另外有一種模式是multirepo，指的是多倉庫代碼(one-repository-per-module)，不同的項目分布在不同的倉庫里。React、Babel、Jest、Vue、Angular均采用monorepo進行項目管理。
典型的monorepo結(jié)構(gòu)是：
├── packages
| ├── pkg1
| | ├── package.json
| ├── pkg2
| | ├── package.json
├── package.json這是Babel源碼的目錄結(jié)構(gòu)：
├─ lerna.json
├─ package.json
└─ packages/ # 這里將存放所有子項目目錄
├─ README.md
├─ babel-cli
├─ babel-code-frame
├─ babel-compat-data
├─ babel-core
├─ babel-generator
├─ babel-helper-annotate-as-pure
├─ babel-helper-builder-binary-assignment-operator-visitor
├─ babel-helper-builder-react-jsx
├─ ...而rollup則采取了multirepo的模式：
├─ rollup
├─ package.json
├─ ...
├─ plugins
├─ package.json
├─ ...
├─ awesome
├─ package.json
├─ ...
├─ rollup-starter-lib
├─ package.json
├─ ...
├─ rollup-plugin-babel
├─ package.json
├─ ...
├─ rollup-plugin-commonjs
├─ package.json
├─ ...monorepo的優(yōu)缺點
優(yōu)點
- 便捷的代碼復(fù)用與依賴管理當所有項目代碼都在一個工程里，抽離可復(fù)用的代碼就十分容易了。并且抽離后，如果復(fù)用的代碼有改動，可以通過一些工具，快速定位受影響的子工程，進而做到子工程的版本控制。
- 便捷的代碼重構(gòu)通過一些工具，monorepo項目中的代碼改動可以快速地定位出代碼變更的影響范圍，對整個工程進行快速的整體測試。而如果子工程分散在不同的工程分支里的話，通用代碼的重構(gòu)將難以觸達各個子工程。
- 倡導(dǎo)開放、共享monorepo項目中，開發(fā)者可以方便地看到所有子工程，這樣響應(yīng)了"開放、共享"的組織文化。可以激發(fā)開發(fā)者對工程質(zhì)量等維護的熱情（畢竟別人看不到自己的代碼，亂不亂就看自己心情了），有助于團隊建立良好的技術(shù)氛圍。
缺點
- 復(fù)雜的權(quán)限管理因為所有子工程集中在一個工程里，某些子工程如果不希望對外展示的話，monorepo的權(quán)限管理就比較難以實現(xiàn)了，難以鎖定目標工程做獨立的代碼權(quán)限管理。
- 較高的熟悉成本相對于multirepo，monorepo涉及各種子工程、通用依賴等，新的開發(fā)者在理解整個項目時，可能需要了解較多的信息才能入手，如通用依賴代碼、各子工程功能。
- 較大的工程體積很明顯，所有子工程集成在一個工程里，代碼體積會非常大，對文件存儲系統(tǒng)等提出了較高的要求。
- 較高的質(zhì)量風(fēng)險成也蕭何敗蕭何，monorepo提供了便捷的代碼復(fù)用能力，同時，一個公用模塊的某個版本有bug的話，很容易影響所有用到它的子工程。此時，做好高覆蓋率的單元測試就比較重要了。
選擇
multirepo和monorepo是兩種不同的理念。
multirepo允許多元化發(fā)展，每個模塊獨立實現(xiàn)自己的構(gòu)建、單元測試、依賴管理等。monorepo抹平了模塊間的很多差異，通過集中管理和高度集成化的工具，減少開發(fā)和溝通時的成本。monorepo最大的問題可能就是不能管理占用空間太大的項目了。
所以，還是要根據(jù)項目的實際需求出發(fā)選擇用哪種項目管理模式。
三、lerna
lerna是基于git/npm/yarn等的工作流提效工具，用于維護monorepo。它是Babel 開發(fā)過程中提升開發(fā)效率產(chǎn)出的工具。
lerna本身也是一個monorepo的項目，并且，lerna為monorepo項目提供了如下支持:
- 項目管理
lerna提供了一系列命令用于monorepo項目初始化、添加子項目、查看項目信息等。
- 依賴管理
lerna支持為monorepo項目統(tǒng)一管理公共依賴、自動安裝各個子項目的依賴、自動創(chuàng)建子模塊符號鏈接等。
- 版本管理
lerna可以根據(jù)項目代碼的變動情況，發(fā)現(xiàn)影響的子項目范圍，在發(fā)布時提供語義化版本推薦等，極大提升了monorepo項目的版本管理效率。
lerna命令集
命令行列表
lerna官網(wǎng)有對各種命令各種用法的詳細介紹，這些命令可以分為：項目管理、依賴管理、版本管理三大類。
圖片
全局配置項
lerna有一批通用參數(shù)，所有子命令均可以使用。
--concurrency
當lerna將任務(wù)并行執(zhí)行時，需要使用多少線程(默認為邏輯CPU內(nèi)核數(shù))。
lerna publish --concurrency 1--loglevel<silent|error|warn|success|info|verbose|silly>
要報告什么級別的日志。如果失敗，所有日志都寫到當前工作目錄中的lerna-debug.log中。
任何高于該設(shè)置的日志都會顯示出來。默認值是"info"。
--max-buffer<bytes>
為每個底層進程調(diào)用設(shè)置的最大緩沖區(qū)長度。例如，當有人希望在運行l(wèi)erna import的同時導(dǎo)入包含大量提交的倉庫時，就是它出場的時候了。在這種情況下，內(nèi)置的緩沖區(qū)長度可能不夠。
--no-progress
禁用進度條。在CLI環(huán)境中總是這樣。
--no-sort
默認情況下，所有任務(wù)都按照拓撲排序的順序在包上執(zhí)行，以尊重所討論的包的依賴關(guān)系。在不保證lerna調(diào)用一致的情況下，以最努力的方式打破循環(huán)。
如果只有少量的包有許多依賴項，或者某些包執(zhí)行的時間長得不成比例，拓撲排序可能會導(dǎo)致并發(fā)瓶頸。--no-sort配置項禁用排序，而是以最大并發(fā)的任意順序執(zhí)行任務(wù)。
如果您運行多個watch命令，該配置項也會有所幫助。因為lerna run將按照拓撲排序的順序執(zhí)行命令，所以在繼續(xù)執(zhí)行之前可能會等待某個命令。當您運行"watch"命令時會阻塞執(zhí)行，因為他們通常不會結(jié)束。
--reject-cycles
如果（在bootstrap、exec、publish或run中）發(fā)現(xiàn)循環(huán)，則立即失敗。
lerna bootstrap --reject-cycles過濾器參數(shù)
--scope<glob>
只包含名稱與給定通配符匹配的包。
lerna exec --scope my-component -- ls -la
lerna run --scope toolbar-* test
lerna run --scope package-1 --scope *-2 lint--ignore<glob>
排除名稱與給定通配符匹配的包。
lerna exec --ignore package-{1,2,5} -- ls -la
lerna run --ignore package-1 test
lerna run --ignore package-@(1|2) --ignore package-3 lint--no-private
排除私有的包。默認情況下是包含它們的。
--since [ref]
只包含自指定ref以來已經(jīng)改變的包。如果沒有傳遞ref，它默認為最近的標記。
# 列出自最新標記以來發(fā)生變化的包的內(nèi)容
$ lerna exec --since -- ls -la
# 為自“master”以來所有發(fā)生更改的包運行測試
$ lerna run test --since master
# 列出自“某個分支”以來發(fā)生變化的所有包
$ lerna ls --since some-branch在CI中使用時，如果您可以獲得PR將要進入的目標分支，那么它將特別有用，因為您可以將其作為--since配置項的ref。這對于進入master和feature分支的PR來說很有效。
--exclude-dependents
當使用--since運行命令時，排除所有傳遞的被依賴項，覆蓋默認的“changed”算法。
如果沒有--since該參數(shù)時無效的，會拋出錯誤。
--include-dependents
在運行命令時包括所有傳遞的被依賴項，無視--scope、--ignore或--since。
--include-dependencies
在運行命令時包括所有傳遞依賴項，無視--scope、--ignore或--since。
與接受--scope(bootstrap、clean、ls、run、exec)的任何命令組合使用。確保對任何作用域的包（通過--scope或--ignore）的所有依賴項（和dev依賴項）也進行操作。
注意：這將會覆蓋--scope和--ignore。
例如，如果一個匹配了--ignore的包被另一個正在引導(dǎo)的包所以來，那么它仍會照常工作。
當您想要“設(shè)置”一個依賴于其他正在設(shè)置的包其中的一個包時，這是非常有用的。
lerna bootstrap --scope my-component --include-dependencies
# my-component 及其所有依賴項將被引導(dǎo)lerna bootstrap --scope "package-*" --ignore "package-util-*" --include-dependencies
# 所有匹配 "package-util-*" 的包將被忽略，除非它們依賴于名稱匹配 "package-*" 的包--include-merged-tags
lerna exec --since --include-merged-tags -- ls -la在使用--since命令時，它包含來自合并分支的標記。這只有在從feature分支進行大量發(fā)布時才有用，通常情況下不推薦這樣做。
lerna原理解析
文件結(jié)構(gòu)
以下是lerna的主要目錄結(jié)構(gòu)（省略了一些文件和文件夾）：
lerna
├─ CHANGELOG.md -- 更新日志
├─ README.md -- 文檔
├─ commands -- 核心子模塊
├─ core -- 核心子模塊
├─ utils -- 核心子模塊
├─ lerna.json -- lerna 配置文件
├─ package-lock.json -- 依賴聲明
├─ package.json -- 依賴聲明
├─ scripts -- 內(nèi)置腳本
└─ yarn.lock -- 依賴聲明有趣的是，lerna本身也是用lerna進行開發(fā)管理的。它是一個monorepo項目，其各個子項目分布在lerna/commands/*、core/*、utils/*目錄下。
另外，在源碼中，經(jīng)常會看到名稱為@lerna/command的子項目，如lerna/core/lerna/index.js的內(nèi)容是：
const cli = require("@lerna/cli");
const addCmd = require("@lerna/add/command");
const bootstrapCmd = require("@lerna/bootstrap/command");
const changedCmd = require("@lerna/changed/command");
const cleanCmd = require("@lerna/clean/command");
const createCmd = require("@lerna/create/command");
const diffCmd = require("@lerna/diff/command");
const execCmd = require("@lerna/exec/command");
const importCmd = require("@lerna/import/command");
const infoCmd = require("@lerna/info/command");
const initCmd = require("@lerna/init/command");
const linkCmd = require("@lerna/link/command");
const listCmd = require("@lerna/list/command");
const publishCmd = require("@lerna/publish/command");
const runCmd = require("@lerna/run/command");
const versionCmd = require("@lerna/version/command");這些子項目分布在lerna/commands/*、core/*、utils/*下，截至本文截稿時，lerna有61個子項目。
以下是各子項目分布：
圖片
命令行注冊
lerna命令注冊工作集中在lerna/core/lerna/*路徑下。
lerna/core/lerna/package.json
該文件的bin字段定義了lerna命令：
"bin": {
"lerna": "cli.js"
}lerna/core/lerna/cli.js
該文件描述了命令行的執(zhí)行入口：
#!/usr/bin/env node
"use strict";
/* eslint-disable import/no-dynamic-require, global-require */
const importLocal = require("import-local");
if (importLocal(__filename)) {
require("npmlog").info("cli", "using local version of lerna");
} else {
require(".")(process.argv.slice(2));
}lerna/core/lerna/index.js
該文件為命令行引入了所有l(wèi)erna指令：
"use strict";
const cli = require("@lerna/cli");
const addCmd = require("@lerna/add/command");
const bootstrapCmd = require("@lerna/bootstrap/command");
const changedCmd = require("@lerna/changed/command");
const cleanCmd = require("@lerna/clean/command");
const createCmd = require("@lerna/create/command");
const diffCmd = require("@lerna/diff/command");
const execCmd = require("@lerna/exec/command");
const importCmd = require("@lerna/import/command");
const infoCmd = require("@lerna/info/command");
const initCmd = require("@lerna/init/command");
const linkCmd = require("@lerna/link/command");
const listCmd = require("@lerna/list/command");
const publishCmd = require("@lerna/publish/command");
const runCmd = require("@lerna/run/command");
const versionCmd = require("@lerna/version/command");
const pkg = require("./package.json");
module.exports = main;
function main(argv) {
const context = {
lernaVersion: pkg.version,
};
return cli()
.command(addCmd)
.command(bootstrapCmd)
.command(changedCmd)
.command(cleanCmd)
.command(createCmd)
.command(diffCmd)
.command(execCmd)
.command(importCmd)
.command(infoCmd)
.command(initCmd)
.command(linkCmd)
.command(listCmd)
.command(publishCmd)
.command(runCmd)
.command(versionCmd)
.parse(argv, context);
}Commander類
lerna的子命令均繼承自Command類，比如lerna init命令定義為：
const { Command } = require("@lerna/command");
class InitCommand extends Command {
...
}Command類定義在@lerna/command，位于lerna/core/command目錄。
有一些寫法值得借鑒，比如個別方法需要InitCommand的實例自行定義，否則拋錯，InitCommand類的定義如下：
class InitCommand extends Command {
...
initialize() {
throw new ValidationError(this.name, "initialize() needs to be implemented.");
}
execute() {
throw new ValidationError(this.name, "execute() needs to be implemented.");
}
}import-local
上文提到，lerna/core/lerna/cli.js描述了命令行的執(zhí)行入口：
#!/usr/bin/env node
"use strict";
/* eslint-disable import/no-dynamic-require, global-require */
const importLocal = require("import-local");
if (importLocal(__filename)) {
require("npmlog").info("cli", "using local version of lerna");
} else {
require(".")(process.argv.slice(2));
}其中，import-local的作用是，實現(xiàn)本地開發(fā)版本和生產(chǎn)版本的切換。import-local/index.js的內(nèi)容是：
'use strict';
const path = require('path');
const resolveCwd = require('resolve-cwd');
const pkgDir = require('pkg-dir');
module.exports = filename => {
const globalDir = pkgDir.sync(path.dirname(filename));
const relativePath = path.relative(globalDir, filename);
const pkg = require(path.join(globalDir, 'package.json'));
const localFile = resolveCwd.silent(path.join(pkg.name, relativePath));
const localNodeModules = path.join(process.cwd(), 'node_modules');
const filenameInLocalNodeModules = !path.relative(localNodeModules, filename).startsWith('..');
// Use path.relative() to detect local package installation,
// because __filename's case is inconsistent on Windows
// Can use === when targeting Node.js 8
// See https://github.com/nodejs/node/issues/6624
return !filenameInLocalNodeModules && localFile && path.relative(localFile, filename) !== '' && require(localFile);
};依賴管理
Babel使用lerna進行依賴管理。其中，lerna自己實現(xiàn)了一套依賴管理機制，也支持基于yarn的依賴管理。這里主要介紹lerna的hoisting。
子模塊相同的依賴可以通過依賴提升（hoisting），將相同的依賴安裝在根目錄下，本地包之間用軟連接實現(xiàn)。
lerna bootstrap
該命令執(zhí)行時，會在每個子項目下面，各自安裝其中package.json聲明的依賴。
這樣會有一個問題，相同的依賴會被重復(fù)安裝，除了占用更多空間外，依賴安裝速度也受影響。
lerna bootstrap --hoist
--hoist標記時，lerna bootstrap會識別子項目下名稱和版本號相同的依賴，并將其安裝在根目錄的node_modules下，子項目的node_modules會生成軟連接。
這樣節(jié)省了空間，也減少了依賴安裝的耗時。
yarn install
當在項目中聲明yarn作為依賴安裝的底層依賴，如：
lerna.json
{
"npmClient": "yarn",
"useWorkspaces": true,
}package.json
{
"workspaces": [
"packages/*"
]
}相對于lerna，yarn提供了更強大的依賴分析能力、hoisting算法。而且，默認情況下，yarn會開啟hoist功能，也可以設(shè)置nohoist關(guān)閉該功能：
{
"workspaces": {
"packages": [
"Packages/*",
],
"nohoist": [
"**"
]
}
}lerna中涉及的git命令
lerna中廣泛使用了git命令用于內(nèi)部工作，這里列舉了lerna中使用的git命令。
git init
git rev-parse
git describe
git rev-list
git tag
git log
git config
git diff-index
git --version
git show
git am
git reset
git ls-files
git diff-tree
git commit
git ls-remote
git checkout
git push
git add
git remote
git show-ref沒有必要逐個介紹git命令，我們選取幾個不是很常見的git命令介紹，了解其作用、lerna哪些命令用到了它們。
git rev-parse
- 主要用于解析git引用（如分支名稱、標簽名稱等）或表達式，并輸出對應(yīng)的SHA-1值。它的作用包括但不限于：
解析提交、分支、標簽等引用，獲取對應(yīng)的SHA-1值。
校驗是否為有效的引用或表達式。
生成git對象的唯一標識符。
下面是一個git rev-parse命令的執(zhí)行結(jié)果案例：
$ git rev-parse HEAD
f7f6d6f2b6b47eb8c4cf4b8bf5f83e0b8028c031- 關(guān)聯(lián)的lerna命令
- lerna version：在執(zhí)行版本升級操作時，lerna會使用git rev-parse來獲取先前提交的哈希值作為上一個版本的參考。
- lerna changed：用于列出自上次標記以來發(fā)生變更的包，可能會用到git rev-parse來比較不同提交之間的差異。
- lerna diff：顯示自上次標記以來的所有包的diff，也可能會使用git rev-parse來比較不同提交之間的差異。
- lerna源碼案例libs/commands/import/src/index.ts
getCurrentSHA() {
return this.execSync("git", ["rev-parse", "HEAD"]);
}
getWorkspaceRoot() {
return this.execSync("git", ["rev-parse", "--show-toplevel"]);
}git describe
- 主要用于根據(jù)最接近的標簽來描述當前提交的位置。它的作用包括但不限于：
找到最接近當前提交的標簽。
根據(jù)最接近的標簽以及提交的SHA-1值生成一個描述字符串。
可以幫助識別當前提交相對于標簽的距離，以及提交是否是基于標簽進行的修改。
下面是一個git describe命令的執(zhí)行結(jié)果案例：
$ git describe
polaris-release-1.0.0-c12345- 關(guān)聯(lián)的lerna命令
- lerna version：在執(zhí)行版本升級操作時，lerna可能會使用git describe 來確定當前提交的位置，以便生成新的版本號。
- lerna源碼案例libs/commands/diff/src/lib/get-last-commit.ts
export function getLastCommit(execOpts?: ExecOptions) {
if (hasTags(execOpts)) {
log.silly("getLastTagInBranch", "");
return childProcess.execSync("git", ["describe", "--tags", "--abbrev=0"], execOpts);
}
log.silly("getFirstCommit", "");
return childProcess.execSync("git", ["rev-list", "--max-parents=0", "HEAD"], execOpts);
}git rev-list
- 主要用于列出提交對象的SHA-1哈希值。它的作用包括但不限于：
列出提交對象的哈希值，可以按時間、作者、提交者等順序進行排序。
支持使用范圍、分支、標簽等參數(shù)來限制輸出的提交范圍。
下面是一個git rev-list命令的執(zhí)行結(jié)果案例：
$ git rev-list HEAD
f7f6d6f2b6b47eb8c4cf4b8bf5f83e0b8028c031
a3d8b4e1c2e1d0a9b8c6e5f7d6a4b3e8a1b2c3d4這里git rev-list HEAD將列出當前HEAD指向的提交及其之前的所有提交的 SHA-1 哈希值。
- 關(guān)聯(lián)的lerna命令
- lerna changed：列出自上次標記以來發(fā)生變更的包，可能會使用git rev-list 來獲取兩個標記之間的提交列表。
- lerna diff：顯示自上次標記以來的所有包的diff，也可能會使用git rev-list 來獲取兩個標記之間的提交列表。
- lerna 源碼案例libs/commands/diff/src/lib/get-last-commit.ts
export function getLastCommit(execOpts?: ExecOptions) {
if (hasTags(execOpts)) {
log.silly("getLastTagInBranch", "");
return childProcess.execSync("git", ["describe", "--tags", "--abbrev=0"], execOpts);
}
log.silly("getFirstCommit", "");
return childProcess.execSync("git", ["rev-list", "--max-parents=0", "HEAD"], execOpts);
}git diff-index
- 主要用于比較索引和工作樹之間的差異，并將其輸出為標準輸出。它的作用包括但不限于：
檢查暫存區(qū)（index）和當前工作目錄之間的差異。
可以與不同的選項一起使用，以便輸出不同格式的差異信息。
下面是一個git diff-index命令的執(zhí)行結(jié)果案例：
$ git diff-index HEAD
:100644 100644 bcd1234... 0123456... M file.txt這里git diff-index HEAD將顯示當前提交（HEAD）和工作目錄之間的差異。
- 關(guān)聯(lián)的lerna命令
- lerna changed：列出自上次標記以來發(fā)生變更的包時，可能會用到git diff-index來比較索引和工作樹之間的差異。
- lerna源碼案例libs/commands/import/src/index.ts
export class ImportCommand extends Command<ImportCommandOptions> {
...
if (this.execSync("git", ["diff-index", "HEAD"])) {
throw new ValidationError("ECHANGES", "Local repository has un-committed changes");
}
...
}git diff-tree
- 主要用于比較兩棵樹之間的差異，并以特定的格式輸出。它的作用包括但不限于：
比較兩個樹對象之間的差異，例如提交對象和樹對象之間的差異。
可以用于查看提交之間的差異，文件的更改等信息。
下面是一個git diff-tree命令的執(zhí)行結(jié)果案例：
$ git diff-tree HEAD~2 HEAD
100644 blob a3d8b4e1c2e1d0a9b8c6e5f7d6a4b3e8a1b2c3d4 file.txt- 關(guān)聯(lián)的lerna命令
- lerna diff：顯示自上次標記以來的所有包的diff時，可能會使用git diff-tree 來比較不同提交之間的差異。
- lerna源碼案例libs/commands/publish/src/lib/get-projects-with-tagged-packages.ts
export async function getProjectsWithTaggedPackages(
projectNodes: ProjectGraphProjectNodeWithPackage[],
projectFileMap: ProjectFileMap,
execOpts: ExecOptions
): Promise<ProjectGraphProjectNodeWithPackage[]> {
log.silly("getTaggedPackages", "");
// @see https://stackoverflow.com/a/424142/5707
// FIXME: --root is only necessary for tests :P
const result = await childProcess.exec(
"git",
["diff-tree", "--name-only", "--no-commit-id", "--root", "-r", "-c", "HEAD"],
execOpts
);
const stdout: string = result.stdout;
const files = new Set(stdout.split("\n"));
return projectNodes.filter((node) => projectFileMap[node.name]?.some((file) => files.has(file.file)));
}git show-ref
- 主要用于顯示引用（如分支和標簽）的名稱和其對應(yīng)的提交哈希值。它的作用包括但不限于：
列出git倉庫中的所有引用及其對應(yīng)的提交哈希值。
可以用于查看分支、標簽等引用的信息。
下面是一個git show-ref命令的執(zhí)行結(jié)果案例：
$ git show-ref
a3d8b4e1c2e1d0a9b8c6e5f7d6a4b3e8a1b2c3d4 HEAD
a3d8b4e1c2e1d0a9b8c6e5f7d6a4b3e8a1b2c3d4 refs/heads/main
f7f6d6f2b6b47eb8c4cf4b8bf5f83e0b8028c031 refs/tags/v1.0.0- 關(guān)聯(lián)的lerna命令
- lerna version：在執(zhí)行版本升級操作時，lerna可能會使用git show-ref 來獲取引用的信息，以確定當前提交的位置。
- lerna源碼案例libs/commands/version/src/lib/remote-branch-exists.ts
export function remoteBranchExists(gitRemote: string, branch: string, opts: ExecOptions) {
log.silly("remoteBranchExists", "");
const remoteBranch = `${gitRemote}/${branch}`;
try {
childProcess.execSync("git", ["show-ref", "--verify", `refs/remotes/${remoteBranch}`], opts);
return true;
} catch (e) {
return false;
}
}
