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

第 54 篇原创好文～
本文首发于政采云前端团队博客：一份值得收藏的 Git 异常处理清单

前言

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

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

1. 本地工作区文件恢复
2. 远程分支删除后，删除本地分支与其关联
3. 修改提交时的备注内容
4. 修改分支名，实现无缝衔接
5. 撤回提交
6. 撤销本地分支合并
7. 恢复误删的本地分支
8. 不确定哪个分支有自己提交的 commit

（一）本地工作区文件恢复

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

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

语法：git checkout <filename/dirname>

命令：git checkout 1.js

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

（二）远程分支删除后，删除本地分支及关联

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

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

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

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

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

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

（三）修改提交时的备注内容

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

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

语法：git commit --amend

命令：git commit --amend

使用 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

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

（五）撤回提交

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

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

• 已将更改交到本地存储，需要撤回提交
• 用新的提交内容替换上一次的提交
• 本地提交了错误的文件

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

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

命令：git reset --soft HEAD~1

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

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

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

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

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

命令：git reset --mixed HEAD~1

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

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

本地提交了错误的文件

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

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

命令：git reset --hard HEAD~1

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

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

（六）撤销本地分支合并

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

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

撤销合并：

语法：git revert <commit-id>

命令：git revert 700920

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

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

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

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

（七）恢复误删的本地分支

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

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

语法：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 :

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

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

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

命令：git branch --contains 700920

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

总结

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

参考文献

Git 错误集锦和修复方法

Git 中.gitignore的配置语法

git reset 和 git revert

招贤纳士

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

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