前言
上一篇文章 Git Worktree 大法真香 帶大家了解了 git worktree 是如何幫助我同時在多個分支工作,並且互不影響的。但是創建 worktree 的目錄位置不是在當前項目下,總感覺創建好的這些 worktree 不屬於當前項目,這對於磁盤管理強迫症的我來說是十分難受的,今天就帶大家了解一種高級用法來解決這個痛點
准備知識
在使用高級用法之前,你需要知道一點 bare repo
知識,我們先從你熟悉的命令開始
git init
git clone https://github.com/FraserYu/amend-crash-demo.git
這兩個命令就會生成一個 non-bare repo
,我們通常都在這樣的 repo
中進行日常工作, 你可以在這里面 add
/commit
/pull
/push
要想生成一個 bare repo
也很簡單, 只需在上面兩個命令的基礎上加上 --bare
參數即可
git init --bare
git clone --bare https://github.com/FraserYu/amend-crash-demo.git
來執行這兩個 clone 命令,並查看文件內容你就會看出差別了
bare repo
僅僅包含 Git 相關信息,並不包含我們的實際項目文件(.java
/.js
/.py
), 而non-bare repo
卻包含我們的全部信息- bare repo 名稱默認是帶有
.git
后綴的,這也恰恰證明了第一點 - bare repo 中是不存在
.git
文件夾的,這也就導致它不能像non-bare repo
那樣add
/commit
/pull
/push
看到這,你可能感覺 bare repo 就是一個 Git 空殼文件夾,一無是處。其實不然,正因為 bare repo 的這些特性(不能對它進行更改),也就避免 repo 里面的內容被弄的一團糟,所以可以被用來做私有的中心化 repo,一張圖解釋,其實就是這樣的:
如果你有興趣,可以按照下面的命令在本地實驗一下整個過程:
user@server:$~ git init --bare name_to_repo.git
user@machine1:$~ git clone user@server:/path/to/repo/name_to_repo.git .
user@machine1:$~ cd name_to_repo
user@machine1:$~ touch README
user@machine1:$~ echo "Hello world" >> README
user@machine1:$~ git add README
user@machine1:$~ git commit -m "Adding a README"
user@machine1:$~ git push origin master
user@server:$~ ls /path/to/repo/name_to_repo.git/
branches/ config description HEAD hooks/ info/ objects/ refs/
user@machine2:$~ git clone user@server:/path/to/repo/name_to_repo.git .
user@machine2:$~ ls name_to_repo.git/
README
user@machine2:$~ cat README
Hello world
實驗結果就是:無論在 machine1 下怎么 push 文件,bare repo 中都不會存在你 push 的文件,只有 Git 相關信息。但是 machine2 clone 最新的 repo 時,卻能看到machine1 push 的文件,這正是 Git 的魔法所在
到這里,bare repo 就解釋完了。接下來,接上一篇 Git Worktree 大法真香 內容,借助 bare repo 的特性,來優化同時在多個分支工作的做法吧
Git Worktree 高級用法
首先,在你選定的目錄下為你的項目(比如這里叫 amend-crash-demo
)單獨創建一個文件夾, 並 cd
進去
mkdir amend-crash-demo
cd amend-crash-demo
接下來以 bare 的形式 clone 項目代碼, 並將內容 clone 到 .bare
文件夾內:
git clone --bare git@github.com:FraserYu/amend-crash-demo.git .bare
我們還要在當前目錄下創建一個 .git
文件,文件內容是以 gitdir
的形式指向我們的 .bare
文件夾 (如果不理解 gitdir 的含義,請回看 Git Worktree 大法真香 )
echo "gitdir: ./.bare" > .git
然后我們要編輯 .bare/config 文件,並修改 [remote "origin"]
內容,和下面內容保持一致(也就是添加第 6 行內容),這確保我們創建 worktree 切換分支,可以顯示正確的分支名稱
vim .bare/config
# -----------------------------------------------
[remote "origin"]
url = git@github.com:FraserYu/amend-crash-demo.git
fetch = +refs/heads/*:refs/remotes/origin/*
接下來我們就可以創建 worktree 了,首先我們要為 main 分支創建 worktree,因為 main 分支 HEAD 的指向的 commit-ish 就是你創建其他 worktree 的 commit-ish
git worktree add main
# --------------------------------
Preparing worktree (checking out 'main')
HEAD is now at 82b8711 add main file
通常我們不會直接在 main 分支上直接工作,而是創建其它類型的分支,繼續創建名為 feature/JIRA234-feature3
的 worktree
git worktree add -b "feature/JIRA234-feature3" feature3
# ------------------------------------------------
Preparing worktree (new branch 'feature/JIRA234-feature3')
HEAD is now at 82b8711 add main file
查看當前文件夾的內容,你會發現只有 main
和 feature3
兩個文件夾(因為 .bare
和 .git
是隱藏文件夾/文件),這樣是不是相當清爽呢?
ls -l
# -------------------------------------------
total 0
drwxr-xr-x 10 rgyb staff 320 Nov 23 21:44 feature3
drwxr-xr-x 10 rgyb staff 320 Nov 23 21:36 main
ls -al
# -------------------------------------------
total 8
drwxr-xr-x 6 rgyb staff 192 Nov 23 21:44 .
drwxr-xr-x 3 rgyb staff 96 Nov 23 21:14 ..
drwxr-xr-x 12 rgyb staff 384 Nov 23 21:36 .bare
-rw-r--r-- 1 rgyb staff 16 Nov 23 21:29 .git
drwxr-xr-x 10 rgyb staff 320 Nov 23 21:44 feature3
drwxr-xr-x 10 rgyb staff 320 Nov 23 21:36 main
接下來就可以盡情的在我們的各種分支上,彼此互不影響的進行 add
/commit
/pull
/push
操作了
echo "feature3 development" > feature3.yaml
git add feature3.yaml
git commit -m "feat: [JIRA234-feature3] feature3 development"
# ------------------------------------------------------------------
[feature/JIRA234-feature3 aeaac94] feat: [JIRA234-feature3] feature3 development
1 file changed, 1 insertion(+)
create mode 100644 feature3.yaml
git push --set-upstream origin feature/JIRA234-feature3
通過上一篇文章 worktree 的四個命令,多分支協同開發不再是問題:
git worktree add
git worktree list
# ------------------------------------------------------------------------------------------------
/Users/rgyb/Documents/projects/amend-crash-demo/.bare (bare)
/Users/rgyb/Documents/projects/amend-crash-demo/feature3 aeaac94 [feature/JIRA234-feature3]
/Users/rgyb/Documents/projects/amend-crash-demo/main 82b8711 [main]
git worktree remove
git worktree prune
總結
通過借助 bare repo 的特性,我們可以非常整潔的將所有 worktree 只管理在當前項目目錄下,多分支協同開發,就像這樣:
.
└── amend-crash-demo
├── feature3
│ ├── README.md
│ ├── config.yaml
│ ├── feat1.txt
│ ├── feature3.yaml
│ ├── file1.yaml
│ ├── hotfix.yaml
│ ├── main.properties
│ └── main.yaml
└── main
├── README.md
├── config.yaml
├── feat1.txt
├── file1.yaml
├── hotfix.yaml
├── main.properties
└── main.yaml
3 directories, 15 files
如果你有磁盤管理強迫症,這絕對是個好辦法。
如果你想更好的理解整個過程,你需要在操作本文命令的同時,查看 Git 相關的文件信息
有什么問題,留言區交流
參考
- https://www.blopig.com/blog/2017/06/using-bare-git-repos/
- https://lists.mcs.anl.gov/pipermail/petsc-dev/2021-May/027448.html
- https://www.saintsjd.com/2011/01/what-is-a-bare-git-repository/
- https://infrequently.org/2021/07/worktrees-step-by-step/
- https://morgan.cugerone.com/blog/how-to-use-git-worktree-and-in-a-clean-way/
個人博客:https://dayarch.top
加我微信好友, 進群娛樂學習交流,備注「進群」
歡迎持續關注公眾號:「日拱一兵」
- 前沿 Java 技術干貨分享
- 高效工具匯總 | 回復「工具」
- 面試問題分析與解答
- 技術資料領取 | 回復「資料」
以讀偵探小說思維輕松趣味學習 Java 技術棧相關知識,本着將復雜問題簡單化,抽象問題具體化和圖形化原則逐步分解技術問題,技術持續更新,請持續關注......