作为程序员的我们应该都有一个感受,一旦进入某个项目,从开发,到发布,到生产,到 hotfix,到后期维护,那基本都有你的份。
正在开发某个 feature,老板突然跳出来说让你做生产上的 hotfix 更是家常便饭,面对这种情况,使用 Git 的我们通常有两种解决方案:
- 草草提交未完成的 feature,然后切换分支到 hotfix
git stash | git stash pop
暂存工作内容,然后再切换到 hotfix
第二种方式较第一种还好很多,可是面对下面这些场景,stash 依旧不是很好的解决方案。
我们面对的场景
- 正在 main 分支上跑长时间的测试,切换到 hotfix 或 feature, 测试就会中断
- 项目非常大,频繁的切换索引,成本非常高
- 有几年前 release 的旧版本,设置和当前不一样,IDE restructure 适配切换也会带来很大的开销
- 切换分支,需要重新设置相应的环境变量,比如 dev/qa/prod
- 需要切换到同事的代码,帮助调试代码复现问题
有的同学想到,git clone 多个 repo 不就可以了吗?这是解决上述问题的一个方法,但背后同样隐藏很多问题:
- 多个 repo 的状态是不好同步的,比如没办法快速 cherry-pick, 一个 repo checkout 的分支,另外一个 repo 需要重新 checkout
- git history/log 是重复的,当项目历史非常长,
.git
文件夹下的内容是非常占用磁盘空间的 - 同一个项目,多个 repo,不易管理
那如何做才能满足这些特殊场景,又不出现这些上述这些问题呢?
git-worktree
其实,这是 Git 2015 年就开始支持的功能,却很少有人知道它,git-worktree 的使用非常方便,在终端输入:就可以快速看到帮助文档说明:
用简单的话来解释 git-worktree 的作用就是:
仅需维护一个 repo,又可以同时在多个 branch 上工作,互不影响
上面红色框线命令有很多,我们常用的其实只有下面这四个:在展开说明之前,需要和大家普及两个你可能忽视的 Git 知识点:
- 默认情况下,
git init
或git clone
初始化的 repo,只有一个worktree
,叫做main worktree
- 在某一个目录下使用 Git 命令,当前目录下要么有
.git
文件夹;要么有.git
文件,如果只有.git
文件,里面的内容必须是指向.git
文件夹的
第二句话感觉挺绕的,下面用例子说明,就很容易明白了
如果您正在学习Spring Cloud,推荐一个连载多年还在继续更新的免费教程:https://blog.didispace.com/spring-cloud-learning/
git worktree add
当前项目目录结构是这样的(amend-crash-demo
是 repo 的 root):重新看目录结构该命令默认会根据 HEAD 所在的 commit-ish (当然也可以指定 git log 中的任意一个 commit-ish) 创建一个名为 feature2 的分支,分支磁盘位置如上面结构所示
cd ../feature/feature2/
会发现,这个分支下并不存在 .git
文件夹,却存在一个 .git
文件,打开文件,内容如下:到这里,你再理解一下上面的知识点2,是不是就清晰许多了呢?
接下来,你就可以在 feature2 分支上做一切你想做的内容了(add/commit/pull/push),和 main worktree 互不干扰
一般情况下,项目组都有一定的分支命名规范,比如 feature/JIRAID-Title
, hotfix/JIRAID-Title
, 如果仅仅按照上面命令新建 worktree,分支名称中的 /
会被当成文件目录来处理运行完该命令,文件目录结构是这样的很显然这不是我们想要的,这时我们就需要 -b 参数的支持了,就像 git checkout -b
一样
执行命令:再来看一下目录结构进入 JIRA234-fix-naming
目录,默认是在 hotfix/JIRA234-fix-naming
分支上
worktree 建立起来很容易,不加管理,项目目录结构肯定乱糟糟,这是我们不想看到的,所以我们需要清晰的知道某个 repo 都建立了哪些 worktree
git worktree list
所有的worktree 都在共用一个 repo,所以在任意一个 worktree 目录下,都可以执行如下命令来查看 worktree 列表执行完命令后,可以查看到我们上面创建的所有 worktree 信息, main worktree
也会显示在此处worktree 的工作做完了,也是要及时删除的,否则也会浪费很多磁盘空间
另外,如果您正在学习Spring Cloud,推荐一个连载多年还在继续更新的免费教程:https://blog.didispace.com/spring-cloud-learning/
git worktree remove此时,分支名弄错的那个 hotfix 就被删掉了假设你创建一个 worktree,并在里面有改动,突然间这个worktree 又不需要了,此刻你按照上述命令是不能删掉了,此时就需要 -f
参数来帮忙了删除了 worktree,其实在 Git 的文件中,还有很多 administrative 文件是没有用的,为了保持清洁,我们还需要进一步清理
git worktree prune
这个命令就是清洁的兜底操作,可以让我们的工作始终保持整洁
总结
到这里,你应该理解,整个 git-worktree 的使用流程就是下面这四个命令:
这个命令很简单了,worktree 的名字叫什么,直接就 remove 什么就好了