开源软件名称：

开源软件地址：

开源编程语言：

开源软件介绍：

目录

1. Git 简介
2. 基本命令
    2.1. git config: 环境设置命令
    2.2. git init: 初始化本地仓库
    2.3. git clone: 克隆远程仓库到本地
    2.4. ssh-keygen: 生成SSH公钥
    2.5. git status 查看当前状态
    2.6. git add: 添加到暂存区
    2.7. git commit: 提交到版本库
    2.8. git log: 查看提交历史
    2.9. git diff: 显示变更内容
    2.10. git reset: 回退版本
    2.11. git push: 推送本地分支到远程
    2.12. git pull: 拉取远程分支到本地并合并
3. 分支管理
    3.1. git branch: 分支操作
    3.2. git checkout: 分支间切换
    3.3. git merge: 合并分支
    3.4. git rebase: 分支的变基
    3.5. git cherry-pick: 挑拣节点合并到当前分支上
4. 其他命令
    4.1. git revert: 撤销某次提交
    4.2. git tag: 标签的操作
    4.3. git show: 显示信息
    4.4. git blame: 查看文件每行的提交历史（追责）
5. 团队协作应用
    5.1 分支设置
    5.2 普通开发人员的操作
    5.3 团队 leader 的操作
6. 结束语

1. Git 简介

Git 的诞生：

Linus(Linux之父)花了两周时间自己用C写了一个分布式版本控制系统，这就是Git！
一个月之内，Linux系统的源码已经由Git管理了！

几个概念：

工作区、版本库、暂存区
如下图所示：

1. 图中左侧为工作区，右侧为版本库。在版本库中标记为index的区域是暂存区（stage,index），标记为master的是master分支所代表的目录树。

2. 图中我们可以看出此时HEAD指针实际是指向master分支的一个“游标”。所以图示的命令中出现 HEAD 的地方可以用 master 来替换。

3. 图中的objects标识的区域为Git的对象库，实际位于.git/objects目录下。

4. 当对工作区修改（或新增）的文件执行git add命令时，暂存区的目录树被更新，同时工作区修改（或新增）的文件内容被写入到对象库中的一个新的对象中，而该对象的ID被记录在暂存区的文件索引中。

5. 当执行提交操作git commit时，暂存区的目录树写到版本库（对象库）中，master分支会做相应的更新。即master指向的目录树就是提交时暂存区的目录树。

6. 当执行git reset HEAD命令时，暂存区的目录树会被重写，被master分支指向的目录树所替换，但是工作区不受影响。

7. 当执行git rm --cached <file>命令时，会直接从暂存区删除文件，工作区则不做出改变。

8. 当执行git checkout .或者git checkout -- <file>命令时，会用暂存区全部或指定的文件替换工作区的文件。这个操作很危险，会清除工作区中未添加到暂存区的改动。

9. 当执行git checkout HEAD .或者git checkout HEAD <file>命令时，会用HEAD指向的master分支中的全部或者部分文件替换暂存区和以及工作区中的文件。这个命令也是极具危险性的，因为不但会清除工作区中未提交的改动，也会清除暂存区中未提交的改动。

2. 基本命令

2.1. git config: 环境设置命令

通常情况下，安装完Git后的第一件事就是设置用户名称和邮件地址。每一个Git的提交都会使用这些信息，如果不设置则无法进行提交。

$ git config --global user.name "goto456" // 设置用户名称
$ git config --global user.email "[email protected]" // 设置邮件地址

使用--global参数表示设置了全局的环境，如果想对与特定的项目使用不同的用户名和邮件地址，则可已在该项目目录下不使用--global参数设置不同的用户名和邮件地址。

git config --list命令可以列出当前Git所有的配置信息。

2.2. git init: 初始化本地仓库

获取一个 Git 仓库有2中方法：

1. 本地初始化一个仓库
2. 从远程克隆一个仓库到本地

对于第1种方式，如果想对本地现有的一个项目用 Git 来管理，可以直接进入该项目的目录下执行如下命令，就可以将其初始化成一个 Git 仓库了。
$ git init

2.3. git clone: 克隆远程仓库到本地

对于第二种方式，也是最常用的方式，比如你在 GitHub 上（或者其他代码托管网站）已经建立了一个项目，你就可以将该项目从远程克隆到本地，这就有了该项目在本地的 Git 仓库。

$ git clone [email protected]:goto456/leetcode.git // 通过ssh方式克隆
$ git clone https://github.com/goto456/leetcode.git // 通过https方式克隆

以上2种方式有如下区别：

1. https方式：不管是谁，只要拿到该项目的 url 可以随便 clone，但是在 push 到远程的时候需要验证用户名和密码；
2. ssh方式：需要现将你电脑的SSH key（SSH公钥）添加到GitHub（或者其他代码托管网站）上，这样在 clone 项目和 push 项目到远程时都不需要输入用户名和密码。

如何生成SSH key，参见下一条命令：ssh-keygen

2.4. ssh-keygen: 生成SSH公钥

生成公钥之前先检查系统中是否已经有了公钥，公钥一般在~/.ssh/目录下。如果该目录下存在id_rsa.pub文件，这就是公钥（id_rsa 文件是私钥）；如果不存在此文件，甚至连.ssh目录都不存在，则需要用 ssh-keygen 命令来生成。如下所示：

$ ssh-keygen // 然后一直按回车键

这就可以生成 SSH key 了，公钥id_rsa.pub文件的内容大致如下所示：

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC/bdrJjo6HNCuzhpTZNVsTju5NnksTca2kRzfbZlFs+8S4bs8hTlo6aV/GJPkTT0zxJfuOgfd4B4O8Xh0NQg51Zl4yCsFdnIKFA0tgBOg/H5oi48Ypoo8h3LO+S8gd8HR5eqndjINx3kCrQx4gISCW25d7GKTm3c40YPoUCIL0Zg4+iuu2ioeVCpv+FSCKhlcrYew7c2aEe3p/oOmATT3UX9S4t94qzy8KkxRlnQ4a8zQ3OTRE23r7+PPHGN8oBAen//NQNn9COUhqU3pHfvtxqYrG1Blhf0t6HhkHz9Fd8StCUIDQv7yHHvuuPFumh3/8PNG8DDPQqWsqXmK2XozT [email protected]

2.5. git status 查看当前状态

可以在任何时候使用该命令查看当前的状态。一般会显示当前所处的分支，以及当前工作区是否干净，是否有文件要提交。
当你克隆远程仓库到本地后，通过该命令查看当前状态时，显示信息如下图所示：

当你修改了一个文件后，再用该命令查看当前状态，显示信息如下图所示：

它会提示你把当前的变更添加到暂存区或者丢弃该变更。

当你新增一个文件后，用该命令查看当前状态，显示信息如下图所示：

它会显示新增的文件状态是未跟踪，并且提示用git add命令将其添加到暂存区。

2.6. git add: 添加到暂存区

无论你新增了一个文件或者对已有的文件进行了修改，都需要将其添加到暂存区，然后提交到版本库。

$ git add hello.txt      //后面接文件名，表示将某个文件添加到暂存区   
$ git add .                 //后面接一个点，表示将全部文件添加到暂存区

分别执行上述2条命令后，如下图所示：

将新增/修改的文件添加到暂存区后，并未提交到版本库，还需要通过git commit命令提交到版本库。

2.7. git commit: 提交到版本库

该命令是将添加到暂存去的变更提交到版本库，主要有一下几个常用的：

$ git commit -m "变更的说明信息"       //标准用法，提交到版本库并填写相关说明信息
$ git commit -am "变更的说明信息"     //加上-a参数，则不需要上一步的git add过程，可以直接将修改过的变更直接提交到版本库，但不会把新增的文件提交

分别执行上述2条命令后，如下图所示：

注：第2条命令一般在不想把新增的文件提交到版本库时用的比较多

执行完git commit命令提交到版本库后，一次简单的流程就算走完了。接下来可以通过git log命令来查看所有的提交历史。

2.8. git log: 查看提交历史

如果发现提交了一个错误版本，想回退到上个版本时，就可以通过该命令来查看所有的历史版本，以选择回退到历史的哪个版本。

$ git log                  //查看历史版本
$ git log --graph     //以图形的方式查看历史（这个我比较常用，能很好的显示各个分支之间的关系）

执行后，如下图所示：

可以看出第2个图的左边显示出了分支的图形

2.9. git diff: 显示变更内容

当你对文件进行了修改，想查看进行了哪些修改时，可以通过该命令查看。
git diff命令会显示修改的文件中哪些内容进行了修改，包括新增了哪些内容，删除了哪些内容。

$ git diff                            //后面不接参数，表示显示所有修改文件的变更
$ git diff README.md      //后面接文件名，表示只显示该文件的变更

例如：我对 README.md 文件进行了修改，删除了1行，新增了2行，然后用该命令查看进行了哪些修改，如下图所示： （“+” 表示新增的内容，“-” 表示删除的内容）

2.10. git reset: 回退版本

常用于回退版本或者在各个版本间进行跳跃切换。 我们可以先用 git log 看一下当前历史版本，如下图所示：

如果要回退到前一个版本，则只需要输入：git reset HEAD~1，执行完再看一下历史版本：

我们已经回退到前一个版本了。

如果需要回退到前2个版本，命令是：git reset HEAD~2，回退到前n个版本就是：git reset HEAD~n
注意：在 Git 中，用 HEAD 表示指向当前版本的指针

如果需要回退到任何一个版本，则需要替换成该版本的 commit id 就可以了，例如：git reset a8336834b50daafa0793370，执行完再看一下历史：

发现我们已经回退到该版本了。

一般情况下会加一个 --hard 参数：git reset --hard HEAD~1 或 git reset --hard a8336834b50daafa0793370，表示回退到某个版本并且丢弃调工作区进行的修改，而不加该参数表示回退到某个版本但保留工作区的修改。

2.11. git push: 推送本地分支到远程

当修改完成，本地的改动都已经提交到本地库，则可以将本地分支推送到远程代码库了。

命令：git push origin master
origin 表示远程代码库的一个别名（也可以修改为其他名字，可通过 git remote 修改），master 表示需要推送的分支名称。

如果，push 的过程中提示当前分支进度落后于远程的分支，则需要通过 git pull 命令来拉取远程最新状态和本地分支进行合并，完成之后再 push 到远程就可以了。

2.12. git pull: 拉取远程分支到本地并合并

一般是本地分支的进度落后于远程分支时，需要使用该命令。

命令：git pull origin master
origin 表示远程代码库的一个别名（也可以修改为其他名字，可通过 git remote 修改），master 表示需要拉取合并的分支名称。

常用 git pull --rebase origin master 用 rebase 的方式进行，不会产生 merge 保持分支干净、整洁

3. 分支管理

3.1. git branch: 分支操作

命令：git branch 用于显示本地所有分支以及当前所在哪个分支。

图中显示本地有 master 和 dev 两个分支，并且正处在 master 分支上。

命令：git branch branchName 用于新建名为 branchName 的新分支。

图中新建了一个名为 test 的新分支。

命令：git branch -d branchName 用于删除名为 branchName 的分支。

图中删除了一个名为 test 的分支。

命令：git branch -D branchName 用于强制删除分支。

3.2. git checkout: 分支间切换

该命令除了进行分支间切换功能外，还可以用来丢弃工作区中的修改内容，这里就不作介绍了，仅介绍分之间的切换功能。

命令：git checkout branchName 用于从当前分支切换到名为 branchName 的分支上。

图中先显示在 master 分支上，后来切换到了 dev 分支上。

命令：git checkout -b branchName 用于新建名为 branchName 的分支并切换到该分支上。

图中新建了 test 分支并切换到了该分支上。
注意与 git branch 新建分支的区别，此处除了新建分支外还进行了切换操作

3.3. git merge: 合并分支

该命令用于合并两个分支。
命令：git merge branchName 用于将名为 branchName 的分支合并到当前分支。
有两种合并方式：

1. fast-forward 方式合并：
   命令：git merge dev

2. 非fast-forward 方式合并：
   命令：git merge dev

注意两种方式的区别：fast-forward 方式仅仅是移动了 HEAD 指针，而非 fast-forward 方式则是新建了一个节点

3.4. git rebase: 分支的变基

命令：git rebase master 将当前分支 rebase 到 master 分支
命令：git rebase master dev 将 dev 分支 rebase 到 master 分支

这种操作很难用语言解释，我用一个图来说明其与 merge 操作的区别：

由图可知，rebase 操作相当于将 C3 节点拿下来换了一个位置重新放置。最后不会产生合并的痕迹，所有分支都是同一条直线。

我们来看一个详细的例子：
你从 master 分支的 C2 上创建了一个新分支 server，为服务端添加了一些功能，提交了 C3 和 C4。 然后从 C3 上创建了特性分支 client，为客户端添加了一些功能，提交了 C8 和 C9。 最后，你回到 server 分支，又提交了 C10。

假设你希望将 client 中的修改合并到主分支并发布，但暂时并不想合并 server 中的修改，因为它们还需要经过更全面的测试。这时，你就可以使用 git rebase 命令的 --onto 选项，选中在 client 分支里但不在 server 分支里的修改（即 C8 和 C9），将它们在 master 分支上重放：

命令：git rebase --onto master server client
以上命令的意思是：“取出 client 分支，找出处于 client 分支和 server 分支的共同祖先之后的修改，然后把它们在 master 分支上重放一遍”。 这理解起来有一点复杂，不过效果非常酷。

现在可以快进合并 master 分支了。（如下图 快进合并 master 分支，使之包含来自 client 分支的修改）：

$ git checkout master
$ git merge client

接下来你决定将 server 分支中的修改也整合进来。 使用 git rebase master server 命令可以直接完成，这样做能省去你先切换到 server 分支，再对其执行变基命令的多个步骤。

$ git rebase master server
如下图 将 server 中的修改变基到 master 上，server 中的代码被“续”到了 master 后面。

然后就可以快进合并主分支 master 了：

$ git checkout master
$ git merge server
至此，client 和 server 分支中的修改都已经整合到主分支里了，你可以删除这两个分支，最终提交历史会变成下图的样子，非常干净、整洁：

$ git branch -d client
$ git branch -d server

3.5. git cherry-pick: 挑拣节点合并到当前分支上

该命令一般用于从其他分支上挑拣某些节点到当前分支。
命令：git cherry-pick commit_id

上图中我想把 ruby_client 分支上的 e43a6 这个节点合并到 master 分支上，但不需要 5ddae 这个节点，那么我们就可以使用下面的命令：
$ git checkout master 先切换到 master 分支
$ git cherry-pick e43a6 将 e43a6 节点挑拣合并到当前分支
完成后如下图所示：

注意：该节点被挑拣合并到 master 上后会产生一个新的节点

4. 其他命令

4.1. git revert: 撤销某次提交

该命令用于撤销历史上的某次提交，注意该撤销操会作为一个新节点存在于分支上：

上图中显示了当前的历史提交，当我要撤销 ab1591eb4e06c1e93fdd50126b9fab8a88d89155 这个节点时，执行如下命令：
命令：git revert ab1591eb4e06c1e93fdd50126b9fab8a88d89155

从图中可以看出，完成操作后，会产生一个新的节点，该节点就是撤销操作产生的。

注意与 git reset 的区别

4.2. git tag: 标签的操作

用于给某次提交打个标签，例如截止到某次提交后完成了某个重大版本的开发，则可以在该次提交打上一个版本的 tag 。

例如，截止到图中的最近一次提交，我们完成了 1.0 版本的开发，则可以通过以下命令为其打上版本的标签。
命令：git tag v1.0 为当前提交打上 v1.0 的标签
命令：git tag v1.0 ab1591eb4e06c1e93fdd50126b9fab8a88d89155 为这个节点打上 v1.0 的标签

图中可以看出 v1.0 标签已经打上了。
如果发现标签打错了，想删除某个标签，则可以通过如下命令来执行。
命令：git tag -d v1.0 删除 v1.0 标签

如果想将标题推送到远程库，则可以使用如下命令来完成。
命令：git push origin --tags 将打的 tag 都推送到远程库

4.3. git show: 显示信息

可用于显示某次提交或者某个 tag 相关的信息。
命令：git show commit_id 显示某次提交的详细信息

命令：git show tag_name 显示某个 tag 的详细信息

4.4. git blame: 查看文件每行的提交历史（追责）

可用于查看某个文件中的每一行是那次提交产生的，是谁提交的，什么时候提交的，提交的版本号是多少等等详细信息，在实际工作中方便对出问题的代码进行追责，找到产生 BUG 的责任人。

命令：git blame file_name

上图中可以看到 README.md 这个文件有 5 行，其中后 4 行都是我在 2018 年提交的，第 1 行是另外一个人在 2017 年提交的。

5. 团队协作应用

在团队协作过程中一般会有多个分支，比如有默认的 master 分支，有用于开发的 dev 分支，还有用于测试的 test 分支，用于对外发布的 release 分支，以及每个开发人员开发不同功能时用到的 feature_xx 分支等等。

公司中一般是用 GitLab 搭建的代码托管服务，几个人的小团队也可以自己搭建。

每个团队业务不一样，分支数量的设置也会不一样，下面我介绍一下我们团队的分支设置，以及普通开发人员和项目 leader 对不同分支的不同权限以及不同的操作。

5.1 分支设置

我们常用的分支有3个（master 分支、dev 分支、test 分支）以及若干个 feature_xx 分支。

1. master 分支：是主分支，是最终上线代码的分支，该分支被设置被保护分支（锁住），普通开发人员没有权限操作，只有团队 leader 有合并的权限；
2. dev 分支：是用于开发的分支，该分支被设置为默认 clone 的分支，也用于合并到 master 之前进行测试的分支，普通开发人员从远程 clone 到本地的默认分支，可以进行合并等操作；
3. test 分支：是用于测试的分支，测试人员可以将自己开发分支中的修改合并到 test 分支在测试环境进行测试，一般该分支不合并到任何分支；
4. feature_xx 分支：是用户开发自己模块功能的特征分支，可以叫 feature_login, feature_ui, feature_payment 等与开发的功能相关的名称，该分支上的功能开发完、测试无误后可合并到 dev 分支上。

5.2 普通开发人员的操作

普通开发人员，一般按照如下几个步骤来进行开发、测试工作就可以了：

1. 将远程 dev 分支 clone 到本地，例如：git clone [email protected]:goto456/test.git；
2. 从 dev 分支拉出（新建）自己的 feature 分支用于开发，例如：git checkout -b feature_login；
3. 在自己的 feature 分支上进行开发工作；
4. 开发完了用 add、commit 等操作提交到当前分支；
5. 如果需要在测试环境进行测试，则将远程 test 分支拉到本地，例如：git branch test origin/test;
6. 将自己的 feature 分支合并到 test 分支，并将 test 分支 push 到远程，例如：git rebase test, git checkout test, git merge feature_login, git push origin test；（注意：我们推荐用 rebase 来合并，以保证分支的整洁、美观）
7. 通过公司的发布平台将远程 test 分支发布到测试环境进行测试；
8. 如果测试没问题或者开始就不需要测试，这可以直接将当前 feature 分支合并到 dev 分支，并 push 到远程库，例如：git rebase dev, git checkout dev, git merge feature_login, git push origin dev；（注意：我们推荐用 rebase 来合并，以保证分支的整洁、美观）
9. 这时表示该功能已经开发完成了，代码的 review 以及发布，需要团队 leader 在合并到 master 操作时进行；这时可以删除了自己的 feature 分支，例如：git branch -d feature_login；
10. 如果在 push 到远程的时候提示需要先 pull 时，我们推荐使用 rebase 的方式：git pull --rebase 以保持分支的整洁、美观。

5.3 团队 leader 的操作

因为只有 leader 有操作 master 分支的权限，所以需要完成 dev 分支到 master 分支的合并，以及后续打 tag 和正式上线发布的工作：

1. 先切换到 dev 分支，并拉取最新的状态，例如：git checkout dev, git pull --rebase origin dev；
2. 进行代码 review 等过程后，合并到 master 分支，例如：git rebase master, git checkout master, git merge dev;（注意：我们推荐用 rebase 来合并，以保证分支的整洁、美观）
3. 为本次完成的版本打上标签，例如：git tag v1.0 -m "release version 1.0"；
4. 将本地合并后的 master 分支以及标签 push 到远程库，例如：git push orgin master --tags。

6. 结束语

以上就是我从自己平时的应用中整理出的一个比较简洁的教程，以及我们团队在实际工作中是如何使用的。希望对大家有所帮助！