GitKraken 详细图文教程

前言

写这篇文章的原因是组内的产品和美术同学，开始参与到git工作流中，但是网上又没有找到一个比较详细的使用教程，所以干脆就自己写了一个[doge]。文章的内容比较基础，介绍了Git内的一些基础概念和基本操作，适合零基础的人作为入门指南。

Git常见的一些概念

1.仓库（repository/repo）:代码和资源的仓库，Git分为本地仓库和远程仓库，Git在启动和主动拉取的时候会将远程仓库的内容同步到本地。远程仓库是托管在服务器上，仅会有一份，并且时刻保持最新。本地仓库则是可以有多份，每个人的本地仓库是互不影响的，而且可以断网进行修改。

2.克隆（Clone)：当远程仓库已经建好，并且没有本地仓库的时候。需要将远程仓库Clone到本地，刚完成克隆的时候，本地仓库与远程是完全相同的。

3.分支(Branch)：一个仓库里在初始化提交的时候会生成一个初始的主分支。之后可以在这个主分支上创建其他新的分支。 当你需要做一些操作并且不想影响到其他人时，可以单独创建一个分支，在分支上开发完功能，最后再合并（Merge）到主干上。

分支同样存在本地和远程的区别，远程分支记录的是远程仓库该分支的内容。本地分支则是保存了你本地仓库修改的内容。如果存在远程分支，但是没有对应的本地分支的情况，可以检出(Checkout)获得一个本地分支。

在GitKraken左侧可以看到所有的本地（Local）和远程(Remote)的分支。同时在中间的主面板也可以看到远程和本地分支的情况，远程的分支显示为一个圆形的图标，本地则为一个小电脑的图标

GitKraken界面介绍

主界面

GitKraken的主界面如下，顶部显示为当前的工程。中间为图形化的Git提交记录，可以看到当前项目的提交情况，左侧为本地/远程分支和贮藏等区域。右侧则为文件修改区

Git文件修改区

文件修改区，当有文件产生变化的时候，会出现如下的提示

点击View change会切换到如下界面，处理当前的修改

右侧的文件修改区可以看到几种不同的文件状态

黄色为该文件进行过修改（本地与远程不同）

红色为该文件已经被删除（远程存在，本地不存在）

绿色为该文件为新增文件  (本地存在，远程不存在)

这里需要注意一点如果本地没有任何修改的时候，修改区是不会显示的

左键点击右侧修改区的文件时，进入修改预览界面。可以看到具体文件修改情况。侧边栏有文件修改情况的缩略图，可以拖动后找到对应的修改位置。左侧则是实际的修改情况。查看完毕后可以选择暂存该文件或者关闭预览

GitKranken基础操作

丢弃修改（Discard）

如果不想要本地的修改了，可以选择将本地修改丢弃，具体操作如下

（1）丢弃单个修改

在修改区内，如果想要某个修改，可以右键点击该文件，选择Discard changeds

之后顶部会出现一个确认弹窗，点击Discard Unstaged changeds按钮，即可还原到修改前的状态

修改和删除的文件都可以进行Discard操作。如果是新增的文件，想要还原，需要右键点击Delete file。

（2）丢弃文件夹内修改

想要丢弃某个文件内的所有修改，需要先将修改区切换成Tree模式，这样修改区的文件就会以树状结构出现

然后右键选择需要丢弃的文件夹，点击Discard all changes in folder

然后点击顶部弹窗的Reset Files

（3）丢弃所有修改

如果想要忽略所有修改，则可以点击左上角的垃圾桶

之后顶部会出现一个弹窗，点击Reset All即可清空整个修改区

贮藏（Stash）

点击顶部的Stash会将当前修改区内所有的修改贮藏起来。

对应的修改会放在下图中的一个小抽屉里。并且会自动按照分支对该Stash进行命名。在develop上贮藏的message就会自动命名为WIP on develop

如果想要修改Stash的名字，可以点击这个小抽屉，点击右侧Stash Message框，修改这个Message

后续如果想要恢复这个Stash内的修改，可以右键点击小抽屉所在的那一行记录，然后选择Pop Stash即可

提交修改（Commit）

Git可以完成离线的开发工作，所有的提交内容可以先提交(Commit)到本地的分支中,此时并不影响远程分支。

具体操作是鼠标移动到修改的文件处，点击右侧的StageFile，即可暂存（Stage）该文件

可以看到文件移动到了下方的Staged Files区域

如果想要暂存所有文件可以点击右上角的Stage all changes

按文件夹暂存则是右键文件夹，然后选择Stage folder

所有需要暂存的文件都放入暂存区后，在Commit Message填写修改日志，点击Commit changes就可以将修改提交到本地仓库

提交修改之后，可以看到主界面会有一条对应日志的提交记录。

拉取(Pull)

当有其他人提交一些更改到远程分支时，需要通过Pull操作将其他人的修改同步到本地。Pull的操作十分简单，只需要点击顶部的Pull按钮即可

在进行Pull之前，有两类本地分支的状态：

第一类最简单，本地和远程都处在同一条线上。代表本地未commit任何文件，但是其他人Push了一些修改到远程分支

此时进行Pull操作之后，远程和本地分支的标识都在同一个地方，说明Pull成功，本地和远程的分支完全一致。

第二类情况是，本地进行修改并且Commit之后，没有推送到远端。

此时本地和远程两条分支在两条线上并且本地和远程分支没有汇合到一起。当远程分支的修改时间在本地Commit之后，远程分支显示在本地分支上方

反之远程分支显示在本地分支下方

直接点击Pull即可进行拉取。Pull完成后，可以看到虽然远程代码和本地依然是在两条线上，但是远程分支汇聚到了本地分支上，代表Pull成功。

推送(Push)

当需要将本地分支的修改推送到远程分支时，就需要进行推送(Push)操作，需要注意的时，在Push之前需要先进行Pull操作，将远程分支的内容同步到本地才可以进行Push。

Push操作也十分简单，点击顶部的Push即可

Push成功之后，可以看到小圆点和小电脑此时处在同一行。说明Push 成功，本地和远程的分支完全一致。

创建分支（Create Branch）

右键希望创建分支的位置，选择Create branch here

之后在左侧会出现一个enter branch name的弹窗，输入分支名后，点击Enter即可创建分支

这里输入的分支名为testBranch，可以看到创建后会有一个小电脑的图标，代表本地分支

检出分支（Checkout）

当想要从一个分支切换到另外一个分支的时候，可以通过Checkout进行切换，具体操作是右键点击需要切换的分支，选择"Checkout 分支名称"。（该操作也可以化简为直接双击分支）

当切换到该分支时，可以看到分支左侧有一个“打钩”的图标.

Checkout可以选择切换到本地分支，或者远程分支。如果不存在本地分支，可以直接双击远程分支的所在的圆点。

会自动生成一个本地分支。

如果已经存在本地分支，并且本地分支和远程和分支不在相同的位置，选择Checkout远程分支，会出现以下提示。如果选择Reset Local Here，相当于将本地分支全部重置，并且同步到远程分支所在的位置。（特别注意，该操作会将本地未Push的Commit全部丢弃，不要轻易执行该操作）如果不希望重置本地分支，可以选择Cancel取消。大多数情况下，如果存在本地分支，都是先Checkout本地分支，然后Pull更新到最新。

合并分支（Merge）

不同的分支之间可以进行Merge操作，比如你在自己分支上进行了一些修改之后，希望将修改同步到主干上时，可以进行Merge操作。同时也可以把主干的修改同步到自己的分支上。

具体的操作是，先切换到目标分支，然后右键点击需要合并的源分支，选择"Merge 源分支 into 目标分支"。这样就可以把来源分支的内容合并的目标分支上。

Merge成功后会自动产生一条合并的日志。并且源分支所代表的那根线也汇聚到目标分支上了

采用提交(Cherry Pick Commit)

有时候你在某个分支上做了多个修改，比如“添加图片”(A)，"修改图片参数"(B),“修改代码”(C)。这时候，你想要在另外一个目标分支上应用A修改，但是又不想其他修改也合并到目标分支，这时候就可以通过Cherry pick commit实现该操作。

具体步骤是，右键点击需要采用的提交，然后选择Cherry pick commit

操作完成之后可以看到目标分支上出现了一条跟采用提交相同的日志

恢复提交(Revert Commit)

如果一个已经提交的修改，希望将它恢复到提交之前的状态，就可以使用Revert Commit操作。只需要右键点击需要恢复的提交，选择Revert commit即可

操作完成之后会自动生成一个Revert日志

处理冲突(Resolve Conflict)

处理冲突是git工作流中最为麻烦的。一般原因是两个分支同时对一个文件进行了修改。下面举一个简单的例子，来模拟这样一个情况。分支BranchA和分支BranchB都有个文件TestScript.cs，里面的内容就是声明了一个变量a,一开始a的值是0。

XML using System.Collections; using System.Collections.Generic; using UnityEngine; public class TestScript : MonoBehaviour {     int a = 0; }

然后在BranchA把a的值改成100，在BranchB的值改成50。然后尝试将BranchB Merge到BranchA上。

可以看到左下角会弹出一个Merge Failed的提示

并且顶部同样会有一个黄色的提示，文件修改区的Conflicted Files会显示哪个文件出现冲突。

点击冲突区的文件，会进入处理冲突的界面。可以看到冲突界面有三块区域

左上角为BranchA的内容

右上角为BranchB的内容

底部为输出区域的内容

这时候如果想要采用BranchA的提交可以点击出现冲突那一行左侧的勾选框

可以看到下方的输出区域的内容也跟着变成跟BranchA相同的修改

这时候冲突便解决完毕了。可以点击右上角的Save按钮，退出处理冲突界面。

此时可以看到TestScript.cs从冲突区，移动到了下方的暂存区。并且自动填入了Commit Message。如果确定采用这次的冲突处理，可以点击左侧的Commit and Merge就完成了整个合并冲突的流程

主界面上也会出现这条Merge成功的Commit信息

实际在操作的过程中会发生单个文件会有多个冲突出现的情况。可以看到输出区域Output，会显示conflict n of m。n代表当前查看的是第n个冲突，m代表一共有几个冲突。可以点击右侧的箭头在不同的冲突之间切换。

有时候会出现单个文件的冲突特别多的情况。或者由于修改prefab或者场景导致不知道如何去一条一条地处理冲突。这时候可以直接点击顶部两个勾选框，选择直接采用哪个分支的文件。比如点击左侧A的勾选框，代表直接采用BranchA上的文件，完全忽略BranchB上的修改。后续可以等待冲突处理完之后再手动将BranchB上的修改添加回来。

在处理冲突直接采用哪个文件时，建议大家按照以下的原则进行选择

(1)、优先采用其他人修改的文件

(2)、优先采用远程分支的文件

(3)、优先采用修改较多的文件

在处理冲突的时候还有一种简单粗暴的处理方式，就是在Conflicted Files选择Mark all resolved

这样GitKranken会把所有冲突标记为已经解决。但是实际上文件的内容并不是正确的，比如前面那个修改a值的例子，选择Mark all resolved的输出内容是下图这个样子。同时把两个分支的内容都填进去了，并且还有

Git自动输出的提示“<<< Head  ===  >>> branchA”，最后还是需要手动地去解决。

GitKranken操作流程

1.清空修改区

在进行Pull或者切换分支的操作之前，需要先清空修改区。

清空有几种方式:

(1)丢弃修改（Discard）

(2)贮藏（Stash）

(3)提交修改（Commit）

具体操作可以查看上一个章节中对应基本操作

2.确定分支

清空完修改区后，需要确定是在哪个分支上进行操作。之后需要切换到对应分支。可以先查看本地是否有该分支。（左侧Local栏），如果存在。直接双击该分支即可切换到该分支上。如果该分支本地仓库不存在，可以直接双击远程分支，这样就可以在本地Checkout了一个对应的分支，并完成切换。

3.同步远程分支

切换到对应分支后需要进行Pull的操作，将远程仓库的修改同步到本地。点击Pull按钮，可以完成Pull操作

4.本地进行修改

在进行本地修改的时候，可以自由地创建本地分支，贮藏，或者提交到本地。

点击完贮藏按钮后可以看到顶部出现一个小抽屉的图标，本地所有的修改都临时保存在这个贮藏中

之后再次拉取最新的分支，验证最终效果。

如果发现仍有需要修改的情况，可以直接在最新的分支上修改。也可以根据情况恢复贮藏的内容，右键刚刚贮藏的小抽屉，选择Pop Stash，恢复修改。

常见问题处理

1.文件被其他程序使用

在进行文件操作的时候，（比如Stash，Discard等）可能会出现如下弹窗，导致无法进行操作。原因是，有文件被其他程序使用了，比如播放器，图片浏览器等。这时候，需要把占用该文件的程序关闭，即可顺利进行操作。（如果实在找不到是哪个程序，可以重启电脑）

2.切换分支失败Checkout Failed

在进行分支切换的时候，有时会因为修改区未清空出现如下报错。清空修改区后再切换分支即可。

创作不易，如果觉得这篇文章对你有所帮助，可以动动小手，点个赞哈，ღ( ´･ᴗ･` )比心