• Stars
    star
    106
  • Rank 325,871 (Top 7 %)
  • Language
  • Created over 6 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

简明 Git 教程。浅显易懂,快速入门!

目录

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管理了!

几个概念:

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

image

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~1git 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 用于显示本地所有分支以及当前所在哪个分支。


图中显示本地有 masterdev 两个分支,并且正处在 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

  1. 非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. 结束语

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