Git Worktree

还在为频繁切换分支而烦恼吗还在为stash暂存命名而挠头吗那就看看 git worktree 吧

git worktree 2015年就有了所以不要担心自己的 git 版本问题

它的主要作用为: 仅需维护一个 repo 就可以同时在多个 branch 上工作互不影响

git init/clone 创建的仓库默认是只有一个 worktree 的

1
2
3
4
5
6
7
8
9
usage: git worktree add [-f] [--detach] [--checkout] [--lock [--reason <string>]]
                        [-b <new-branch>] <path> [<commit-ish>]
   or: git worktree list [-v | --porcelain [-z]]
   or: git worktree lock [--reason <string>] <worktree>
   or: git worktree move <worktree> <new-path>
   or: git worktree prune [-n] [-v] [--expire <expire>]
   or: git worktree remove [-f] <worktree>
   or: git worktree repair [<path>...]
   or: git worktree unlock <worktree>

showcase

下面主要用一个实例来演示如何使用

1
2
3
4
5
6
7
8
9
# 可以创建在 ignore 路径 或者 上级路径
git worktree add _drafts misc
git worktree list # 能看见两个分支的 worktree 所在路径和目前 commit hash
# git worktree move _drafts ../parent_misc # move 的 source 需要是一个 worktree
cd _drafts
git log # 看到的是 misc 分支的 log 信息
cd ..
# 修改完之后可以删除 worktree
git worktree remove _drafts

感觉比较适合用于 dotfiles 的更新当前的 dotfiles 依赖于某个分支然后主要使用软链接然后更新其他分支的时候通过 worktree 进行