一份值得收藏的 Git 异常处理清单

avatar
@政采云有限公司@政采云技术

这是第 53 篇不掺水的原创,想获取更多原创好文,请扫 👆 上方二维码关注我们吧~
本文首发于政采云前端团队博客:一份值得收藏的 Git 异常处理清单

前言

Git 作为一种分布式版本控制系统已经成为现在开发的宠儿,不仅应用在前端、后端、客户端等开发场景中,也成为各行业互联网企业分工协作的必备技能之一。

大家在使用过程中总会碰到这样那样的问题,本文主要针对以下经常发生的几种异常情况提供一些解决方案:

  1. 本地工作区文件恢复

  2. 远程分支删除后,删除本地分支与其关联

  3. 修改提交时的备注内容

  4. 修改分支名,实现无缝衔接

  5. 撤回提交

  6. 撤销本地分支合并

  7. 恢复误删的本地分支

  8. 不确定哪个分支有自己提交的 commit

(一)本地工作区文件恢复

大家都知道,一个文件夹中的文件如果被删掉了,那只有在垃圾箱里面找了。如果垃圾箱里面的也被删掉了,以笔者的常识在不借助工具的情况下怕是就找不到了,emmmm。。。

不过,关联了 Git 的文件和文件夹就不一样了,有了本地仓库和远程仓库的双重保护,找到一个被删除的文件也不过就分分钟,一个命令行的事情吧。

语法git checkout <filename/dirname>

命令git checkout 1.js

这一命令主要用于本地工作区文件的撤回,下图是一个工作区文件被删除后的完美恢复过程。

1.png

(二)远程分支删除后,删除本地分支及关联

为方便分支提交,一般情况下会用本地命令 git branch --set-upstream-to=origin/master master 建立本地分支与远程分支的关联,从 master 拉出的分支可以自动建立与远程已有分支的关联,这样可以很方便的使用 git pullgit push 拉取远程分支的代码和将本地分支提交到远程。

Git 远程分支删除之后,本地分支就无法成功推送到远程,想要重新建立与远程仓库的关联,就需要先删除其原本的与已删除的远程分支的关联。

如下图所示,需要删除的远程分支为 feature/test,使用 git push origin --delete feature/test 删除掉对应的远程分支之后,删除本地分支关联。

2(1).png

语法git branch --unset-upstream <branchname>

命令git branch --unset-upstream feature/test

删除掉关联关系之后,用 git branch -vv 命令可查看到本地分支与远程分支的关联关系如下图所示,可观察到 feature/test 分支已经没有关联的远程分支了。

2(2).png

(三)修改提交时的备注内容

平时提交代码很多时候因为军情紧急,会在刚提交的时候填写了自己不太满意的备注,但笔者本人有点强迫症,一定要把它改成想要的样子咋办。。。。,不要慌,还是有解决办法滴!

想要修改最近一次提交的“修改xxx功能”的备注:

3(1).png

语法git commit --amend

命令git commit --amend

3(2).png

使用 git log --pretty=oneline 查看内容,发现已经成功修改啦。需要注意的是此项命令会修改提交时的commit-id,即会覆盖原本的提交,需要谨慎操作

(四)修改分支名,实现无缝衔接

开发中的大佬都是拥有极快手速的人,建了个分支一不小心打错了某个字母或者两个字母打反了,可能就与本意存在较大误差了,Git 提供一种已经拉取了分支,在上面开发了不少的内容,但后来发现原本拉的分支名字就有问题的修复方法。

例如,我们的想新建的分支名为 feature/story-13711,却写成了 feature/stor-13711:

语法git branch -m <oldbranch> <newbranch>

命令git branch -m feature/stor-13711 feature/story-13711

4.png

执行完之后发现文件的工作区已修改内容一点都没有变化,真正的实现了无痛过渡,皆大欢喜!

(五)撤回提交

日常工作中,可能由于需求变更、或者误操作等原因需要进行提交的撤回:

如下分析了各种原因撤销的场景,主要包括:

  • 已将更改交到本地存储,需要撤回提交

  • 用新的提交内容替换上一次的提交

  • 本地提交了错误的文件

已将更改提交到本地,需要撤回提交

语法git reset --soft [<commit-id>/HEAD~n>]

命令git reset --soft HEAD~1

命令执行完成后,查看文件变更记录,可发现如下图所示:

5(2).png

文件变更记录与未提交之前的文件变更记录是一致的,只是撤销了 commit 的操作。

用新的更改替换撤回的更改

提交之中可能有些地方需要优化,我们可以撤销本次的 commit 以及文件暂存状态,修改之后再重新添加到暂存区进行提交。

语法git reset --mixed [<commit-id>/HEAD~n>]

命令git reset --mixed HEAD~1

命令执行完成后,查看文件变更记录,可发现如下图所示:

5(3).png

已变更的文件都未添加到暂存区,撤销了 commit 和 add 的操作。

本地提交了错误的文件

本地将完全错误的,本不应提交的内容提交到了仓库,需要进行撤销,可以使用 --hard 参数

语法git reset --hard [<commit-id>/HEAD~n>]

命令git reset --hard HEAD~1

命令执行完成后,查看文件变更记录,可发现如下图所示:

5(4).png

已追踪文件的变更内容都消失了,撤销了 commit 和 add 的操作,同时撤销了本地已追踪内容的修改;未追踪的内容不会被改变。从上面的效果可以看到,文件的修改都会被撤销。-hard 参数需要谨慎使用

(六)撤销本地分支合并

实际操作中,总会有很多的干扰,导致我们合并了并不该合并的分支到目标分支上。解决这种问题的方式有两种,git resetgit revert。 reset 的语法和命令之前已经介绍过,不做赘述, revert 的语法和命令和 reset 一致。但是产生的实际效果会有不同。

可以先来看下 revert 操作的实际效果,合并分支之后的效果如下图所示:

6(1).png

撤销合并:

语法git revert <commit-id>

命令git revert 700920

下图为执行命令后的效果:

6(2).png

经过前后对比可知,revert 执行之后会在原本的记录中新增一条提交记录。

reset 如上 “本地文件撤销” 例子所述,会删除掉原本已有的提交记录,在合并分支中,会删除原本合并分支的记录。revert 则有不同,会保留原本合并分支的记录,并在其上新增一条提交记录,便于之后有需要仍然能够回溯到 revert 之前的状态。

从需要提交到远程分支的角度来讲,reset 能够“毁尸灭迹”,不让别人发现我们曾经错误的合并过分支(注:多人协作中,需要谨慎使用);revert 则会将合并分支和撤回记录一并显示在远程提交记录上。

(七)恢复误删的本地分支

本地分支拉取之后,由于疏忽被删除,而且本地的分支并没有被同步到远程分支上,此时想要恢复本地分支。

误删的分支为 feature/delete,使用 git reflog 命令可查看到该仓库下的所有历史操作,如下图所示:

7(1).png

语法git checkout -b <branch-name> <commit-id>

命令git checkout -b feature/delete HEAD@{2}

命令执行完成后,分支恢复到 HEAD@{2} 的快照,即从 master 分支拉取 feature/delete 分支的内容,仍然缺少“新增xxx文件”的提交,直接将文件内容恢复到最新的提交内容,使用命令 git reset --hard HEAD@{1} 即可实现硬性覆盖本地工作区内容的目的。git reflog 命令获取到的内容为本地仓库所有发生过的变更,可谓恢复利器,既可向前追溯,亦可向后调整,满满的时光追溯器的赶脚啊。。。

(八)不确定哪个分支有自己提交的 commit

工作中会经常碰到一种场景,某个提交先后合并到了各个分支上,但后来发现提交的这个修改是有问题的,需要排查到底哪个分支包含这个提交,然后将其修复掉。

需要先确定有问题的提交的 commit-id :

8(1).png

然后查看本地所有的分支:

8(2).png

可以看到本地有 4 个分支,本地的分支数量非人为控制的,在使用状态的分支直接删掉也不合适,分支数量达到一定程度,一个一个分支查找也不现实。Git 提供了一种能够直接通过 commit-id 查找出包含该内容分支的命令。

语法git branch --contains <commit-id>

命令git branch --contains 700920

命令执行后可以看到包含该问题提交的分支如下图所示,就可以很方便的在对应分支上修复内容啦。

8(3).png

总结

本文介绍的是实际工作场景中可能出现的几种异常情况及解决方式,希望能够对大家有所帮助,不足之处敬请指正。实际上现在已经有很多 Git 操作对应的工具可以使用,需要明白的是工具中的每个操作等同于 Git 命令行的哪个命令,会有什么样的结果,以避免一些不必要发生的错误。

参考文献

Git 错误集锦和修复方法

Git 中.gitignore的配置语法

git reset 和 git revert

推荐阅读

图解 HTTP 缓存

可能是最全的 “文本溢出截断省略” 方案合集

图文并茂,为你揭开“单点登录“的神秘面纱

招贤纳士

政采云前端团队(ZooTeam),一个年轻富有激情和创造力的前端团队,隶属于政采云产品研发部,Base 在风景如画的杭州。团队现有 50 余个前端小伙伴,平均年龄 27 岁,近 3 成是全栈工程师,妥妥的青年风暴团。成员构成既有来自于阿里、网易的“老”兵,也有浙大、中科大、杭电等校的应届新人。团队在日常的业务对接之外,还在物料体系、工程平台、搭建平台、性能体验、云端应用、数据分析及可视化等方向进行技术探索和实战,推动并落地了一系列的内部技术产品,持续探索前端技术体系的新边界。

如果你想改变一直被事折腾,希望开始能折腾事;如果你想改变一直被告诫需要多些想法,却无从破局;如果你想改变你有能力去做成那个结果,却不需要你;如果你想改变你想做成的事需要一个团队去支撑,但没你带人的位置;如果你想改变既定的节奏,将会是“ 5 年工作时间 3 年工作经验”;如果你想改变本来悟性不错,但总是有那一层窗户纸的模糊… 如果你相信相信的力量,相信平凡人能成就非凡事,相信能遇到更好的自己。如果你希望参与到随着业务腾飞的过程,亲手推动一个有着深入的业务理解、完善的技术体系、技术创造价值、影响力外溢的前端团队的成长历程,我觉得我们该聊聊。任何时间,等着你写点什么,发给 ZooTeam@cai-inc.com