天天看点

万字详解!Git 入门最佳实践 !

前言

git简介

实用主义

深入探索

总结

参考资料

 <code>git</code> 是程序员学习和工作都离不开发工具,今天和大家分享 <code>git</code> 常用命令总结。

<code>git</code> 是一种分布式版本控制系统,它可以不受网络连接的限制,加上其它众多优点,目前已经成为程序开发人员做项目版本管理时的首选,非开发人员也可以用 <code>git</code> 来做自己的文档版本管理工具。

大概是大二的时候开始接触和使用git,从一开始的零接触到现在的重度依赖,真是感叹 <code>git</code> 的强大。

<code>git</code> 的api很多,但其实平时项目中90%的需求都只需要用到几个基本的功能即可,所以本文将从 <code>实用主义</code> 和 <code>深入探索</code> 2个方面去谈谈如何在项目中使用 <code>git</code>,一般来说,看完 <code>实用主义</code> 这一节就可以开始在项目中动手用。

“ 说明:本文的操作都是基于 mac 系统

进入 git官网 下载合适你的安装包,安装好 <code>git</code> 后,打开命令行工具,进入工作文件夹(为了便于理解我们在系统桌面上演示),创建一个新的demo文件夹。

万字详解!Git 入门最佳实践 !

进入 github网站 注册一个账号并登录,进入 我的博客,点击 <code>clone or download</code> ,再点击<code>use https</code> ,复制项目地址 <code>https://github.com/gafish/gafish.github.com.git</code> 备用。

再回到命令行工具,一切就绪,接下来进入本文的重点。

所谓实用主义,就是掌握了以下知识就可以玩转 <code>git</code>,轻松应对90%以上的需求。以下是实用主义型的git命令列表,先大致看一下

<code>git clone</code>

<code>git config</code>

<code>git branch</code>

<code>git checkout</code>

<code>git status</code>

<code>git add</code>

<code>git commit</code>

<code>git push</code>

<code>git pull</code>

<code>git log</code>

<code>git tag</code>

接下来,将通过对 我的博客 仓库进行实例操作,讲解如何使用 <code>git</code> 拉取代码到提交代码的整个流程。

从git服务器拉取代码

代码下载完成后在当前文件夹中会有一个 <code>gafish.github.com</code> 的目录,通过 <code>cd gafish.github.com</code> 命令进入目录。

配置开发者用户名和邮箱

每次代码提交的时候都会生成一条提交记录,其中会包含当前配置的用户名和邮箱。

创建、重命名、查看、删除项目分支,通过 <code>git</code> 做项目开发时,一般都是在开发分支中进行,开发完成后合并分支到主干。

创建一个名为 <code>daily/0.0.0</code> 的日常开发分支,分支名只要不包括特殊字符即可。

如果觉得之前的分支名不合适,可以为新建的分支重命名,重命名分支名为 <code>daily/0.0.1</code>

通过不带参数的branch命令可以查看当前项目分支列表

如果分支已经完成使命则可以通过 <code>-d</code> 参数将分支删除,这里为了继续下一步操作,暂不执行删除操作

切换分支

切换到 <code>daily/0.0.1</code> 分支,后续的操作将在这个分支上进行

查看文件变动状态

通过任何你喜欢的编辑器对项目中的 <code>readme.md</code> 文件做一些改动,保存。

通过 <code>git status</code> 命令可以看到文件当前状态 <code>changes not staged for commit:</code> (改动文件未提交到暂存区)

添加文件变动到暂存区

通过指定文件名 <code>readme.md</code> 可以将该文件添加到暂存区,如果想添加所有文件可用 <code>git add .</code> 命令,这时候可通过 <code>git status</code> 看到文件当前状态 <code>changes to be committed:</code> (文件已提交到暂存区)

提交文件变动到版本库

通过 <code>-m</code> 参数可直接在命令行里输入提交描述文本

将本地的代码改动推送到服务器

<code>origin</code> 指代的是当前的git服务器地址,这行命令的意思是把 <code>daily/0.0.1</code> 分支推送到服务器,当看到命令行返回如下字符表示推送成功了。

现在我们回到github网站的项目首页,点击 <code>branch:master</code> 下拉按钮,就会看到刚才推送的<code>daily/00.1</code> 分支了

将服务器上的最新代码拉取到本地

如果其它项目成员对项目做了改动并推送到服务器,我们需要将最新的改动更新到本地,这里我们来模拟一下这种情况。

进入github网站的项目首页,再进入 <code>daily/0.0.1</code> 分支,在线对 <code>readme.md</code> 文件做一些修改并保存,然后在命令中执行以上命令,它将把刚才在线修改的部分拉取到本地,用编辑器打开 <code>readme.md</code> ,你会发现文件已经跟线上的内容同步了。

如果线上代码做了变动,而你本地的代码也有变动,拉取的代码就有可能会跟你本地的改动冲突,一般情况下 <code>git</code> 会自动处理这种冲突合并,但如果改动的是同一行,那就需要手动来合并代码,编辑文件,保存最新的改动,再通过 <code>git add .</code> 和 <code>git commit -m 'xxx'</code> 来提交合并。

查看版本提交记录

通过以上命令,我们可以查看整个项目的版本提交记录,它里面包含了<code>提交人</code>、<code>日期</code>、<code>提交原因</code>等信息,得到的结果如下:

提交记录可能会非常多,按 <code>j</code> 键往下翻,按 <code>k</code> 键往上翻,按 <code>q</code> 键退出查看

为项目标记里程碑

当我们完成某个功能需求准备发布上线时,应该将此次完整的项目代码做个标记,并将这个标记好的版本发布到线上,这里我们以 <code>publish/0.0.1</code> 为标记名并发布,当看到命令行返回如下内容则表示发布成功了

设置哪些内容不需要推送到服务器,这是一个配置文件

<code>.gitignore</code> 不是 <code>git</code> 命令,而在项目中的一个文件,通过设置 <code>.gitignore</code> 的内容告诉<code>git</code> 哪些文件应该被忽略不需要推送到服务器,通过以上命令可以创建一个 <code>.gitignore</code> 文件,并在编辑器中打开文件,每一行代表一个要忽略的文件或目录,如:

以上内容的意思是 <code>git</code> 将忽略 <code>demo.html</code> 文件 和 <code>build/</code> 目录,这些内容不会被推送到服务器上

通过掌握以上这些基本命令就可以在项目中开始用起来了,如果追求实用,那关于 <code>git</code> 的学习就可以到此结束了,偶尔遇到的问题也基本上通过 <code>google</code> 也能找到答案,如果想深入探索 <code>git</code> 的高阶功能,那就继续往下看 <code>深入探索</code> 部分。

就是你在电脑里能看到的目录,比如上文中的 <code>gafish.github.com</code> 文件夹就是一个工作区

工作区有一个隐藏目录 <code>.git</code>,这个不算工作区,而是 <code>git</code> 的版本库。

本地版本库里存了很多东西,其中最重要的就是称为 <code>stage</code>(或者叫index)的暂存区,还有<code>git</code> 为我们自动创建的第一个分支 <code>master</code>,以及指向 <code>master</code> 的一个指针叫 <code>head</code>。

一般指的是 <code>git</code> 服务器上所对应的仓库,本文的示例所在的<code>github</code>仓库就是一个远程版本库

<code>工作区</code>、<code>暂存区</code>、<code>本地版本库</code>、<code>远程版本库</code>之间几个常用的 <code>git</code> 操作流程如下图所示:

分支是为了将修改记录的整个流程分开存储,让分开的分支不受其它分支的影响,所以在同一个数据库里可以同时进行多个不同的修改

前面提到过 <code>master</code> 是 <code>git</code> 为我们自动创建的第一个分支,也叫主分支,其它分支开发完成后都要合并到 <code>master</code>

<code></code>

标签是用于标记特定的点或提交的历史,通常会用来标记发布版本的名称或版本号(如:<code>publish/0.0.1</code>),虽然标签看起来有点像分支,但打上标签的提交是固定的,不能随意的改动,参见上图中的<code>1.0</code> / <code>2.0</code> / <code>3.0</code>

<code>head</code> 指向的就是当前分支的最新提交

以上概念了解的差不多,那就可以继续往下看,下面将以具体的操作类型来讲解 <code>git</code>的高阶用法
添加文件到暂存区

通过此命令将打开交互式子命令系统,你将看到如下子命令

通过输入序列号或首字母可以选择相应的功能,具体的功能解释如下:

<code>status</code>:功能上和 <code>git add -i</code> 相似,没什么鸟用

<code>update</code>:详见下方 <code>git add -u</code>

<code>revert</code>:把已经添加到暂存区的文件从暂存区剔除,其操作方式和 <code>update</code> 类似

<code>add untracked</code>:可以把新增的文件添加到暂存区,其操作方式和 <code>update</code> 类似

<code>patch</code>:详见下方 <code>git add -p</code>

<code>diff</code>:比较暂存区文件和本地版本库的差异,其操作方式和 <code>update</code> 类似

<code>quit</code>:退出 <code>git add -i</code> 命令系统

<code>help</code>:查看帮助信息

直接进入交互命令中最有用的 <code>patch</code> 模式

这是交互命令中最有用的模式,其操作方式和 <code>update</code> 类似,选择后 <code>git</code> 会显示这些文件的当前内容与本地版本库中的差异,然后您可以自己决定是否添加这些修改到暂存区,在命令行 <code>stage deletion [y,n,q,a,d,/,?]?</code> 后输入 <code>y,n,q,a,d,/,?</code> 其中一项选择操作方式,具体功能解释如下:

y:接受修改

n:忽略修改

q:退出当前命令

a:添加修改

d:放弃修改

/:通过正则表达式匹配修改内容

?:查看帮助信息

直接进入交互命令中的 <code>update</code> 模式

它会先列出工作区 <code>修改</code> 或 <code>删除</code> 的文件列表,<code>新增</code> 的文件不会被显示,在命令行 <code>update&gt;&gt;</code> 后输入相应的列表序列号表示选中该项,回车继续选择,如果已选好,直接回车回到命令主界面

添加工作区 <code>修改</code> 或 <code>新增</code> 的文件列表, <code>删除</code> 的文件不会被添加

把暂存区的文件提交到本地版本库

不打开编辑器,直接在命令行中输入多行提交原因

将工作区 <code>修改</code> 或 <code>删除</code> 的文件提交到本地版本库, <code>新增</code> 的文件不会被提交

修改最新一条提交记录的提交原因

将当前文件改动提交到 <code>head</code> 或当前分支的历史id

移动或重命名文件、目录

将 <code>a.md</code> 重命名为 <code>b.md</code> ,同时添加变动到暂存区,加 <code>-f</code> 参数可以强制重命名,相比用 <code>mv a.md b.md</code> 命令省去了 <code>git add</code> 操作

从工作区和暂存区移除文件

从工作区和暂存区移除文件 <code>b.md</code> ,同时添加变动到暂存区,相比用 <code>rm b.md</code> 命令省去了<code>git add</code> 操作

允许从工作区和暂存区移除目录

以简短方式查看工作区和暂存区文件状态,示例如下:

查看工作区和暂存区文件状态,包括被忽略的文件

查看、创建、删除分支

查看本地版本库和远程版本库上的分支列表

查看远程版本库上的分支列表,加上 <code>-d</code> 参数可以删除远程版本库上的分支

分支未提交到本地版本库前强制删除分支

查看带有最后提交id、最近提交原因等信息的本地版本库分支列表

将其它分支合并到当前分支

将待合并分支上的 <code>commit</code> 合并成一个新的 <code>commit</code> 放入当前分支,适用于待合并分支的提交记录不需要保留的情况

默认情况下,<code>git</code> 执行"<code>快进式合并</code>"(fast-farward merge),会直接将 <code>master</code> 分支指向<code>develop</code> 分支,使用 <code>--no-ff</code> 参数后,会执行正常合并,在 <code>master</code> 分支上生成一个新节点,保证版本演进更清晰。

在没有冲突的情况下合并,不想手动编辑提交原因,而是用 <code>git</code> 自动生成的类似 <code>merge branch 'test'</code> 的文字直接提交

创建 <code>daily/0.0.1</code> 分支,同时切换到这个新创建的分支

从本地版本库的 <code>head</code>(也可以是提交id、分支名、tag名) 历史中检出 <code>demo.html</code> 覆盖当前工作区的文件,如果省略 <code>head</code> 则是从暂存区检出

这个命令会创建一个全新的,完全没有历史记录的新分支,但当前源分支上所有的最新文件都还在,真是强迫症患者的福音,但这个新分支必须做一次 <code>git commit</code> 操作后才会真正成为一个新分支。

这个命令主要用来比较两个分支间的差异内容,并提供交互式的界面来选择进一步的操作,这个命令不仅可以比较两个分支间的差异,还可以比较单个文件的差异。

在 <code>git</code> 的栈中保存当前修改或删除的工作进度,当你在一个分支里做某项功能开发时,接到通知把昨天已经测试完没问题的代码发布到线上,但这时你已经在这个分支里加入了其它未提交的代码,这个时候就可以把这些未提交的代码存到栈里。

将未提交的文件保存到git栈中

查看栈中保存的列表

显示栈中其中一条记录

移除栈中其中一条记录

从git栈中检出最新保存的一条记录,并将它从栈中移除

从git栈中检出其中一条记录,但不从栈中移除

把当前栈中最近一次记录检出并创建一个新分支

清空栈里的所有记录

为当前修改或删除的文件创建一个自定义的栈并返回一个id,此时并未真正存储到栈里

将 <code>create</code> 方法里返回的id放到 <code>store</code> 后面,此时在栈里真正创建了一个记录,但当前修改或删除的文件并未从工作区移除

显示提交历史记录

显示带提交差异对比的历史记录

显示 <code>demo.html</code> 文件的历史记录

显示2周前开始到现在的历史记录,其它时间可以类推

显示截止到2周前的历史记录,其它时间可以类推

显示最近10条历史记录

显示从提交id <code>f5f630a</code> 到 <code>head</code> 之间的记录,<code>head</code> 可以为空或其它提交id

在一行中输出简短的历史记录

格式化输出历史记录

<code>git</code> 用各种 <code>placeholder</code> 来决定各种显示内容,我挑几个常用的显示如下:

%h: commit hash

%h: 缩短的commit hash

%t: tree hash

%t: 缩短的 tree hash

%p: parent hashes

%p: 缩短的 parent hashes

%an: 作者名字

%an: mailmap的作者名

%ae: 作者邮箱

%ad: 日期 (--date= 制定的格式)

%ar: 日期, 相对格式(1 day ago)

%cn: 提交者名字

%ce: 提交者 email

%cd: 提交日期 (--date= 制定的格式)

%cr: 提交日期, 相对格式(1 day ago)

%d: ref名称

%s: commit信息标题

%b: commit信息内容

%n: 换行

合并分支的一条或几条提交记录到当前分支末梢

合并提交id <code>170a305</code> 到当前分支末梢

将当前的分支重设(reset)到指定的 <code>&lt;commit&gt;</code> 或者 <code>head</code>

<code>--mixed</code> 是不带参数时的默认参数,它退回到某个版本,保留文件内容,回退提交历史

暂存区和工作区中的内容不作任何改变,仅仅把 <code>head</code> 指向 <code>&lt;commit&gt;</code>

自从 <code>&lt;commit&gt;</code> 以来在工作区中的任何改变都被丢弃,并把 <code>head</code> 指向 <code>&lt;commit&gt;</code>

重新定义分支的版本库状态

合并分支,这跟 <code>merge</code> 很像,但还是有本质区别,看下图:

合并过程中可能需要先解决冲突,然后执行 <code>git rebase --continue</code>

打开文本编辑器,将看到从 <code>head</code> 到 <code>head~~</code> 的提交如下

将第一行的 <code>pick</code> 改成 <code>commands</code> 中所列出来的命令,然后保存并退出,所对应的修改将会生效。如果移动提交记录的顺序,将改变历史记录中的排序。

撤销某次操作,此次操作之前和之后的 <code>commit</code> 和 <code>history</code> 都会保留,并且把这次撤销作为一次最新的提交

撤销前一次提交操作

撤销前一次提交操作,并以默认的 <code>revert "xxx"</code> 为提交原因

需要撤销多次操作的时候加 <code>-n</code> 参数,这样不会每次撤销操作都提交,而是等所有撤销都完成后一起提交

查看工作区、暂存区、本地版本库之间的文件差异,用一张图来解释
万字详解!Git 入门最佳实践 !

通过 <code>--stat</code> 参数可以查看变更统计数据

<code>reflog</code> 可以查看所有分支的所有操作记录(包括commit和reset的操作、已经被删除的commit记录,跟 <code>git log</code> 的区别在于它不能查看已经删除了的commit记录

万字详解!Git 入门最佳实践 !

如果在github项目初始化之前,文件已经存在于本地目录中,那可以在本地初始化本地版本库,再将本地版本库跟远程版本库连接起来

在本地目录内部会生成.git文件夹

不带参数,列出已经存在的远程分支,加上 <code>-v</code> 列出详细信息,在每一个名字后面列出其远程url

添加一个新的远程仓库,指定一个名字,以便引用后面带的url

将远程版本库的更新取回到本地版本库

默认情况下,<code>git fetch</code> 取回所有分支的更新。如果只想取回特定分支的更新,可以指定分支名。

查看文件每行代码块的历史信息

截取 <code>demo.html</code> 文件1-10行历史信息

二分查找历史记录,排查bug

开始二分查找

标记当前二分提交id为有问题的点

标记当前二分提交id为没问题的点

查到有问题的提交id后回到原分支

通过 git 子模块可以跟踪外部版本库,它允许在某一版本库中再存储另一版本库,并且能够保持2个版本库完全独立

将 <code>demo</code> 仓库添加为子模块

更新子模块 <code>demo</code>

运行git的垃圾回收功能,清理冗余的历史快照
将加了tag的某个版本打包提取

<code>--format</code> 表示打包的格式,如 <code>zip</code>,<code>-v</code> 表示对应的tag名,后面跟的是tag名,如 <code>v0.1</code>。

本文只是对 <code>git</code> 的所有功能中的部分实用功能做了一次探秘,git非常强大,还有很多功能有待我们去发现,限于本文篇幅,咱就此打住吧,预知更多好用功能,请善用谷歌。