Git 的正确使用姿势与最佳实践(十)|青训营笔记
Git 的正确使用姿势与最佳实践(十)|青训营笔记
这是我参与「第三届青训营 -后端场」笔记创作活动的的第十篇笔记。
课前准备
Git安装
首先安装git,可以到 GitHub 的页面上下载 exe 安装文件并运行:安装包下载地址:https://gitforwindows.org/。官网慢,可以用国内的镜像:https://npm.taobao.org/mirrors/git-for-windows/。
Git 配置
在 Windows 系统上,Git 会找寻用户主目录下的 .gitconfig 文件。主目录即 $HOME 变量指定的目录,一般都是 C:\Documents and Settings$USER。
此外,Git 还会尝试找寻 /etc/gitconfig 文件,只不过看当初 Git 装在什么目录,就以此作为根目录来定位。
通过命令配置全局的账号:
git config --global user.name "LiDongLiang"
git config --global user.email 1120752964@qq.com
果用了 --global 选项,那么更改的配置文件就是位于你用户主目录下的那个,以后你所有的项目都会默认使用这里配置的用户信息。
如果要在某个特定的项目中使用其他名字或者电邮,只要去掉 --global 选项重新配置即可,新的设定保存在当前项目的 .gitconfig 文件里。
可以通过git config --list查看配置。
Git 工作流程
一般工作流程如下:
- 克隆 Git 资源作为工作目录。
- 在克隆的资源上添加或修改文件。
- 如果其他人修改了,你可以更新资源。
- 在提交前查看修改。
- 提交修改。
- 在修改完成后,如果发现错误,可以撤回提交并再次修改并提交。
下图展示了 Git 的工作流程:
Git 工作区、暂存区和版本库
我们先来理解下 Git 工作区、暂存区和版本库概念:
- 工作区:就是你在电脑里能看到的目录。
- 暂存区:英文叫 stage 或 index。一般存放在 .git 目录下的 index 文件(.git/index)中,所以我们把暂存区有时也叫作索引(index)。
- 版本库:工作区有一个隐藏目录 .git,这个不算工作区,而是 Git 的版本库。
下面这个图展示了工作区、版本库中的暂存区和版本库之间的关系:
- 图中左侧为工作区,右侧为版本库。在版本库中标记为 "index" 的区域是暂存区(stage/index),标记为 "master" 的是 master 分支所代表的目录树。
- 图中我们可以看出此时 "HEAD" 实际是指向 master 分支的一个"游标"。所以图示的命令中出现 HEAD 的地方可以用 master 来替换。
- 图中的 objects 标识的区域为 Git 的对象库,实际位于 ".git/objects" 目录下,里面包含了创建的各种对象及内容。
- 当对工作区修改(或新增)的文件执行 git add 命令时,暂存区的目录树被更新,同时工作区修改(或新增)的文件内容被写入到对象库中的一个新的对象中,而该对象的ID被记录在暂存区的文件索引中。
- 当执行提交操作(git commit)时,暂存区的目录树写到版本库(对象库)中,master 分支会做相应的更新。即 master 指向的目录树就是提交时暂存区的目录树。
- 当执行 git reset HEAD 命令时,暂存区的目录树会被重写,被 master 分支指向的目录树所替换,但是工作区不受影响。
- 当执行 git rm --cached
命令时,会直接从暂存区删除文件,工作区则不做出改变。 - 当执行 git checkout . 或者 git checkout --
命令时,会用暂存区全部或指定的文件替换工作区的文件。这个操作很危险,会清除工作区中未添加到暂存区中的改动。 - 当执行 git checkout HEAD . 或者 git checkout HEAD
命令时,会用 HEAD 指向的 master 分支中的全部或者部分文件替换暂存区和以及工作区中的文件。这个命令也是极具危险性的,因为不但会清除工作区中未提交的改动,也会清除暂存区中未提交的改动。
Git 创建仓库
- git init
Git 使用 git init 命令来初始化一个 Git 仓库,Git 的很多命令都需要在 Git 的仓库中运行,所以 git init 是使用 Git 的第一个命令。
在执行完成 git init 命令后,Git 仓库会生成一个 .git 目录,该目录包含了资源的所有元数据,其他的项目目录保持不变。
使用当前目录作为 Git 仓库,我们只需使它初始化。
git init
该命令执行完后会在当前目录生成一个 .git 目录。
使用我们指定目录作为Git仓库。
git init newrepo
初始化后,会在 newrepo 目录下会出现一个名为 .git 的目录,所有 Git 需要的数据和资源都存放在这个目录中。
如果当前目录下有几个文件想要纳入版本控制,需要先用 git add 命令告诉 Git 开始对这些文件进行跟踪,然后提交:
$ git add *.c
$ git add README
$ git commit -m '初始化项目版本'
以上命令将目录下以 .c 结尾及 README 文件提交到仓库中。-m代表这次提交的注释。
注: 在 Linux 系统中,commit 信息使用单引号 ' ',Windows 系统,commit 信息使用双引号" "。
- git clone
我们使用 git clone 从现有 Git 仓库中拷贝项目(类似 svn checkout)。
克隆仓库的命令格式为:
git clone <repo>
如果我们需要克隆到指定的目录,可以使用以下命令格式:
git clone <repo> <directory>
参数说明:
- repo:Git 仓库。
- directory:本地目录。
比如,要克隆 Ruby 语言的 Git 代码仓库 Grit,可以用下面的命令:
$ git clone git://github.com/schacon/grit.git
执行该命令后,会在当前目录下创建一个名为grit的目录,其中包含一个 .git 的目录,用于保存下载下来的所有版本记录。
如果要自己定义要新建的项目目录名称,可以在上面的命令末尾指定新的名字:
$ git clone git://github.com/schacon/grit.git mygrit
- 配置
git 的设置使用 git config 命令。
显示当前的 git 配置信息:
$ git config --list
credential.helper=osxkeychain
core.repositoryformatversion=0
core.filemode=true
core.bare=false
core.logallrefupdates=true
core.ignorecase=true
core.precomposeunicode=true
编辑 git 配置文件:
git config -e # 针对当前仓库
或者:
git config -e --global # 针对系统上所有仓库
设置提交代码时的用户信息:
git config --global user.name "runoob"
git config --global user.email test@runoob.com
如果去掉 --global 参数只对当前仓库有效。
Git 基本操作(常用命令)
Git 的工作就是创建和保存你项目的快照及与之后的快照进行对比。
本章将对有关创建与提交你的项目快照的命令作介绍。
Git 常用的是以下 6 个命令:git clone、git push、git add 、git commit、git checkout、git pull,后面我们会详细介绍。
说明:
- workspace:工作区
- staging area:暂存区/缓存区
- local repository:版本库或本地仓库
- remote repository:远程仓库
命令的详细解释可以点击链接查看:
-
git init 初始化仓库
-
git clone 拷贝一份远程仓库,也就是下载一个项目。
git clone https://github.com/tianqixin/runoob-git-test another-runoob-name
another-runoob-name是克隆到本地,本地新建的文件夹的名称。
-
git add 添加文件到暂存区
文件修改后,我们一般都需要进行 git add 操作,从而保存历史版本。
git add README hello.php
-
git status 查看仓库当前的状态,显示有变更的文件。
git status 命令用于查看在你上次提交之后是否有对文件进行再次修改。
通常我们使用 -s 参数来获得简短的输出结果:但是这个是只显示暂存区和工作区的内容,工作区的话是??,暂存区的是A,对暂存区再修改是M,commit后就空了。
-
git diff 比较文件的不同,即暂存区和工作区这两个区与上一次提交前的差异。
git diff 命令显示已写入暂存区和已经被修改但尚未写入暂存区文件的区别。
git diff 有两个主要的应用场景。
- 尚未缓存的改动:git diff
- 查看已缓存的改动(显示暂存区和上一次提交(commit)的差异): git diff --cached
- 查看已缓存的与未缓存的所有改动:git diff HEAD
- 显示摘要而非整个 diff:git diff --stat
显示暂存区和工作区的差异:
$ git diff [file]
显示暂存区和上一次提交(commit)的差异:
$ git diff --cached [file] 或 $ git diff --staged [file]
显示两次提交之间的差异:
$ git diff [first-branch]...[second-branch]
在 hello.php 文件中输入以下内容:
<?php echo '菜鸟教程:www.runoob.com'; ?>
使用 git status 查看状态:
AM代表add后又修改了git status 显示你上次提交更新后的更改或者写入缓存的改动, 而 git diff 一行一行地显示这些改动具体是啥。
接下来我们来查看下 git diff --cached 的执行效果:
-
git commit 提交暂存区到本地仓库。
记得用-m 添加备注信息,默认是提交暂存区所有文件,也可以在后面跟暂存区的文件名来提交。
-a 参数设置修改文件后不需要执行 git add 命令(爽得很),直接来提交。 -
git reset 回退版本。
-
git rm 将文件从暂存区和工作区中删除。
-
如果删除之前修改过并且已经放到暂存区域的话,则必须要用强制删除选项 -f。
强行从暂存区和工作区中删除修改后的 runoob.txt 文件:
git rm -f runoob.txt
-
git mv 移动或重命名工作区文件。
-
git log 查看历史提交记录
-
git blame 以列表形式查看指定文件的历史修改记录
-
git remote 远程仓库操作 这里我们碰到远程,需要先弄好Github或者Gitee,可以先行阅读下方的配置本地连接Github。
显示所有远程仓库:当然要在有.git目录的地方使用git remote -v
以下我们先载入远程仓库,然后查看信息:
origin 为远程地址的别名。后面就是git remote show/add/rm/rename
这里只有git remote add比较特别,第一个参数是本地的版本库的名字 第二个是链接,其余的都是直接在后面追加别名或者链接即可。 -
git fetch 从远程获取代码库
可以在github上修改test内中的文件:
然后执行git fetch origin,再紧接着执行git merge
会发现本地的文件更新了。
该命令就是在执行 git fetch 之后紧接着执行 git merge 远程分支到你所在的任意分支。
假设你配置好了一个远程仓库,并且你想要提取更新的数据,你可以首先执行 git fetch [alias] 告诉 Git 去获取它有你没有的数据,然后你可以执行 git merge [alias]/[branch] 以将服务器上的任何更新(假设有人这时候推送到服务器了)合并到你的当前分支。 -
git pull 下载远程代码并合并
git pull 其实就是 git fetch 和 git merge FETCH_HEAD 的简写。
命令格式如下:
git pull <远程主机名> <远程分支名>:<本地分支名>
将远程主机 origin 的 master 分支拉取过来,与本地的 brantest 分支合并。
git pull origin master:brantest
如果远程分支是与当前分支合并,则冒号后面的部分可以省略。
git pull origin master
可以获得新的文件。
配置本地连接Github
这里可以配合基本操作的13-15食用。
首先在本地创建ssh key;
ssh-keygen -t rsa -C "your_email@youremail.com"
后面的your_email@youremail.com
改为你在github上注册的邮箱,之后会要求确认路径和输入密码,我们这使用默认的一路回车就行。成功的话会在~/
下生成.ssh
文件夹,进去,打开id_rsa.pub
,复制里面的key
。
回到github上,进入 Account Settings(账户配置),左边选择SSH Keys,Add SSH Key,title随便填,粘贴在你电脑上生成的key。
注意:id_rsa是本地的私钥,id_rsa.pub是要输入github的key。
为了验证是否成功,在git bash下输入:
$ ssh -T git@github.com
如果是第一次的会提示是否continue,输入yes就会看到:You've successfully authenticated, but GitHub does not provide shell access 。这就表示已成功连上github。
接下来我们要做的就是把本地仓库传到github上去,在此之前还需要设置username和email,因为github每次commit都会记录他们。(当然我们之前已经做过这件事了)
git config --global user.name "your name"
git config --global user.email "your_email@youremail.com"
新建仓库并复制地址:
这样我们就完成了第一步,新建了一个远程仓库。
接下来我们新建test文件夹,进入test文件夹 ,执行git init命令,新建一个test.txt,git add .,然后git commit ,然后push,如图:
新建test.txt
这里的git remote -v是查看是否有远程的绑定仓库,绑定后才能推送,origin是本地库的名称。
这里会发现已经提交成功。
所以具体的流程就是新建库,在本地初始化,然后绑定,推送。
这里需要注意上传最大容量为2GB:
Git分支管理
几乎每一种版本控制系统都以某种形式支持分支,一个分支代表一条独立的开发线。
使用分支意味着你可以从开发主线上分离开来,然后在不影响主线的同时继续工作。
![img](Git 的正确使用姿势与最佳实践(十)青训营笔记.assets/git-brance.svg+xml)
Git 分支实际上是指向更改快照的指针。
有人把 Git 的分支模型称为必杀技特性,而正是因为它,将 Git 从版本控制系统家族里区分出来。
创建分支命令:
git branch (branchname)
切换分支命令:
git checkout (branchname)
当你切换分支的时候,Git 会用该分支的最后提交的快照替换你的工作目录的内容, 所以多个分支不需要多个目录。
合并分支命令:
git merge
你可以多次合并到统一分支, 也可以选择在合并之后直接删除被并入的分支。
开始前我们先创建一个测试目录:
-
列出分支
列出分支基本命令:
git branch
没有参数时,git branch 会列出你在本地的分支。
$ git branch * master
此例的意思就是,我们有一个叫做 master 的分支,并且该分支是当前分支。
当你执行 git init 的时候,默认情况下 Git 就会为你创建 master 分支。
如果我们要手动创建一个分支。执行 git branch (branchname) 即可。
现在我们可以看到,有了一个新分支 testing。
接下来我们将演示如何切换分支,我们用 git checkout (branch) 切换到我们要修改的分支:
当你以此方式在上次提交更新之后创建了新分支,如果后来又有更新提交, 然后又切换到了 testing 分支,Git 将还原你的工作目录到你创建分支时候的样子。我们也可以使用 git checkout -b (branchname) 命令来创建新分支并立即切换到该分支下,从而在该分支中操作。
如你所见,我们创建了一个分支,在该分支上移除了文件 test.txt,并添加了 newtest.txt文件,然后切换回我们的主分支,删除的 test.txt 文件又回来了,且新增加的 newtest.txt 不存在主分支中。
使用分支将工作切分开来,从而让我们能够在不同开发环境中做事,并来回切换。
-
删除分支
删除分支命令:
git branch -d (branchname)
-
分支合并
一旦某分支有了独立内容,你终究会希望将它合并回到你的主分支。 你可以使用以下命令将任何分支合并到当前分支中去:git merge
以上实例中我们将 newtest 分支合并到主分支去,test.txt 文件被删除,新增了newtest.txt。合并完后就可以删除分支:
-
合并冲突
合并并不仅仅是简单的文件添加、移除的操作,Git 也会合并修改。首先我们删除其他的分支,然后在主分支中查看文件内容:
此时newtest.txt中内容为空。然后新建并切换分支到change_site分支中,修改newtest.txt,并且提交到该分支仓库中:
在里面插入:change_site内容
提交到change_site分支中。然后切换到master分支,此时newtest.txt为空,我们插入master insert内容:
现在这些改变已经记录到我的 "master" 分支了。接下来我们将 "change_site" 分支合并过来。
我们将前一个分支合并到 master 分支,一个合并冲突就出现了,接下来我们需要手动去修改它:
这里所做的事情就是,把master insert和change_site insert全删了,修改成了resove insert,然后add命令添加,再次提交,解决冲突成功。此时change_site分支中的newtest.txt中的内容依旧是change_site insert,而master分支中为
resove insert。我们可以看到,当遇到冲突的时候,需要本地修改文件再add后再commit即可,合并的最终版本就是修改后提交的版本,分支中的内容不会更改。
Git标签
如果你达到一个重要的阶段,并希望永远记住那个特别的提交快照,你可以使用 git tag 给它打上标签。
比如说,我们想为我们的 runoob 项目发布一个"1.0"版本。 我们可以用 git tag -a v1.0 命令给最新一次提交打上(HEAD)"v1.0"的标签。
-a 选项意为"创建一个带注解的标签"。 不用 -a 选项也可以执行的,但它不会记录这标签是啥时候打的,谁打的,也不会让你添加个标签的注解。 我推荐一直创建带注解的标签。
git tag -a v1.0
当你执行 git tag -a 命令时,Git 会打开你的编辑器,让你写一句标签注解,就像你给提交写注解一样。
现在,注意当我们执行 git log --decorate 时,我们可以看到我们的标签了:
如果我们忘了给某个提交打标签,又将它发布了,我们可以给它追加标签。
例如,假设我们发布了提交 85fc7e7(上面实例最后一行),但是那时候忘了给它打标签。 我们现在也可以:
注意 后面的编码应当是代码的开头部分。
使用git tag可以查看版本:
小结
到这里,菜鸟教程上面的Git内容大致总结完毕,感觉对Git有了大致的了解,接下来就可以快乐的看青训营的视频了捏。
课程目录
Git是什么
版本控制
分布式的版本控制系统。下面是历史:
本地版本控制
集中版本控制
分布式版本控制
Git发展历史
Git的基本使用方式
常见问题:
问题1:有可能是密钥没配置,有可能是没有权限。
问题2:可能fetch到了origin分支。
Git目录介绍
这里用到了tree命令,而gitbash中没有,我们需要下载:Tree命令下载,下载第一个安装后将GnuWin32\bin目录下的tree.exe复制到Git的安装目录下的/usr/bin中即可。
使用Tree命令查看初始化的.git文件:
使用Windows的cmd命令查看:
HEAD中存放的是指向当前的分支 master:
config:当前仓库配置
hooks会配置一些hook
objects存储一些文件信息
refs存储分支信息
工作区是本地文件,add到暂存区,commit到仓库。
Git Config
最高级的是system 其次是global 最后是local 低级别会覆盖高级别配置。
常见的Git配置
Instead of 可以吧ssh协议换成https的
Git Remote
拉从一个仓库,推到另一个仓库。
当然熟悉了的话可以直接改配置文件也行(仅限于对配置)。
HTTP Remote
因为像go这种需要很多库,如果说每次clone都需要拉代码,每个操作都要做认证就很麻烦,所以需要配置一下免密的认证方式。
http的免密有两种,第一种是内存第二种是硬盘。不推荐用http的一个是不安全,一个是不方便,一般是用SSH的。
SSH Remote
因为前两种即dsa和rsa有些已经不适用了,这也是有时拉不下代码的原因之一。搞一遍和之前一样,不过是ed25519的。
Git Add
会发现目录中Objects中多了一个文件。
可以通过这个命令查看
Git Commit
会发现objects中多了两个对象,之前是只有55开头的。
查看新增的文件:
可以看到3a开头的文件是一个blob类型的文件,代表内容。
b4开头的是一个tree:目录。一个 tree
对象可包含多个 blob
或 tree
。
这篇文章介绍了git的本质(一个内容寻址文件系统,核心是一个键值对数据库),还介绍了git对象类型以及对象的生成方式:blob类型_git 对象类型。
git
有以下对象类型:
blob
: 文件内容tree
: 目录。一个tree
对象可包含多个blob
或tree
commit
: 提交。commit
通常指向一个tree
对象,并保存了代码作者、提交信息、父提交引用等数据tag
: 标签,可以认为是一个永不移动的分支引用。通常指向一个固定的commit
对象
通过git log命令可以看到最新的就是b4开头的commit:
Objects
Refs
提交前:
提交后:
我们可以发现refs中也发生了变化,heads中多了个master,查看:
发现里面存储的就是之前的commit的ID。
我们可以新建test分支并切换过去,观察目录的变化:
发现里面的test中存放的也是刚出commit的ID。
创建一个Tag:
会发现依然是之前的commit。
总结一下就会发现这个是基于commit的一个标记,branch是会变的标记,tag是稳定的标记。整个系统是围绕着commit去查询的。
Annotation Tag
什么是附注标签?
一种特殊的Tag,可以给Tag提供一些额外的信息。
如何创建辅助标签?
通过git tag -a命令来完成附注标签的创建。
查看tags/v0.0.2中的内容:
会发现不再是最近的一次commit(b4开头),而是新添加了一个对象,34开头,查看内容:
这就是第四种对象,tag对象,里面还是有commit的那个ID。
blob、tree、tag、commit
追溯历史版本
- 修改文件,并提交,创建新的commit:
可以看到从4个对象变成了7个,新增一个commit会顺带新增一个blob(这里是因为只有一个文件readme.md,所以只有一个文件blob)和tree。 - 查看最新的commit,新增了parent信息。
先通过git log查看最新的commit是什么,然后根据ID去查找最新的commit的内容:
会发现parentID中记录了上一次commit的ID,因此可以串联起所有的commit,所有的commit中有所有的tree,tree里有所有的blob,所以所有的文件都能被找到。
修改历史版本
这里只尝试第一个命令:
修改了commit message,多加了几个!。
通过git log查看发现commit ID已经变化,然后根据ID查看内容,里面只有message信息发生了变化:
我们观察tree .git会发现多了一个新的Object,ref指向的commit也变成了最新的commit。
不过老的commit object理论上应该被删掉,因为没有ref指向它了,再也不会被用到,但是并没有被删除,被称之为悬空的Object,可以通过命令查看有无悬空的:
Git GC
执行这两行命令来分别完成对日志的过期和gc时间的修改。
发现tree目录发生了很大的变化:
可以看到其实只是删除了原有的悬空的对象,然后将内容打包了一下。
完整的Git视图
Git Clone & Pull & Fetch
如果很自信就pull,对代码部分不清晰就先fetch。
Git Push
push是将本地代码同步到远端的方式。
对常见问题的解答
Git研发流程
常见问题
不同的工作流
集中式工作流
Gerrit
分支管理工作流
GitFlow
Github Flow
新建test库,然后本地git clone一下:
修改并提交:
新建分支 修改内容 并提交和推送:
这里可以通过remote中的链接复制到浏览器打开,直接点击创建Full Request:
可以在Pull Reques页面执行CI/CA/CR等操作,都检查通过后,执行merge。
pull到本地可以发现多了一个merge。
这里可以配置一些规则,诸如能否允许强制提交之类的:
记得在最上面写上main(分支名),这样就不能随意更push了: