可以在GitHub下载离线版的笔记,链接如下:https://github.com/FangYang970206/GitNote,觉得不错的话,欢迎fork和star
许多人刚开始学习git和github的时候,分不清git和github的关系,以为它们是一样的,我也犯过这个错误。那么git和github分别是什么呢?它们为什么总在一起称呼?
简单来说,git是一套管理软件开发版本的分布式控制系统,而GitHub是用来托管代码的网站。用户可以通过Git将软件代码上传到Github上,全世界的程序猿可以通过GitHub查看代码,使用Git共同开发不同版本的软件。
版本控制主要经历了三个时期,分别是本地版本控制,集中版本控制以及现在的分布式版本控制。下面分别来说说。
本地版本控制顾名思义,就在自己的电脑上进行版本控制,通过复制项目的整个目录以及给项目标注更改项和更改时间,在电脑本地存储所有的版本。具体框图如下:
然而这种版本不够灵活,不能进行不同系统的协同开发,于是下一个集中式版本控制应运而生。
集中式版本控制则是将软件代码存在中央服务器中,开发者可以通过远程下载最新代码或者提交更新,多人协作更加方便。具体框图如下:
缺点是中央服务器万一崩溃或者数据库损坏,轻则宕机,重则失去所有代码和所有提交历史,无法恢复。这时候分布式版本控制就来发挥它的作用力。
分布式相比于集中式,就算服务器中的所有数据全部丢失,也可以通过本地的仓库进行恢复,因为每一次克隆,本地中都包含了软件的所有版本以及提交历史。具体框图如下:
由于笔者没有接触过mac,所以只写window和linux下的安装方法。
linux(基于Dedian)下:
$ sudo apt-get install git
window下:
点击链接下载git,默认运行安装即可,另外提一句,git里可以指定默认编辑器,个人比较喜欢VScode,所以比较推荐VScode啦!
进入官网后,点击sign up进行注册即可,会有邮箱认证填写经历什么的,这个很简单,不多说了。注册完了可以点击sign in进行登陆,浏览器记住账号即可。
仓库的英文是repository,一般简说repo,代码存储在repo中,安装完git和创建完github账号,我们就可以创建我们自己的第一个repo啦!
进入自己的github主页,点击自己图像旁边的加号,然后点击New repository,如图所示
然后在填写相关仓库的一些信息,然后点击creat repository
git的远程管理是基于SSH的,所以需要进行SSH的配置,这样你才能访问自己的仓库。
首先,在bash(window桌面右键有git bash,linux则直接终端进行即可)中设置Git的User name
和email
(注册名字和邮箱):
$ git config --global user.name "FangYang970206"
$ git config --global user.email "15270989505@163.com"
然后,我们可以看看自己电脑里有没有ssh密钥,linux下是在/home/.ssh
,window是在C:\Users\Username\.ssh
,有则备份删除,然后在终端中运行
ssh-keygen -t rsa -C "15270989505@163.com"
按3个回车,密码为空,得到了两个文件:id_rsa
和id_rsa.pub
,然后打开id_rsa.pub,复制里面的内容,最后面的计算机名字不要复制,然后打开https://github.com,点击自己头像中的Setting
,然后选择SSH and GPG keys
,点击New SSH key
,title随便写,下面的key粘贴刚才复制的内容,最后点击Add SSH key
,成功SSH and GPG keys
就会有SSH key的显示,如笔者界面所示(window和ubuntu各一个)
点击我们刚刚创建的仓库,可以看到如下界面
首先我们在桌面创建一个文件夹,名字也取playground好了,我们可以安装上图的一个小教程来初步试试(仓库地址不同,请使用自己的地址哦)
echo "# playground" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin git@github.com:FangYang970206/playground.git
git push -u origin master
运行完上面的命令,我们重新打开我们刚才创建的仓库,你就会发现已经有所变化,我们已经把README.md文件上传到了我们的仓库中。
通过上面的一个小事例,没接触过git可能有比较多的疑问,下面我们来一步步进行讲解。
echo "# playground" >> README.md
不用多说,就是将使用echo命令将# playground
写入README.md
中git init
是初始化本地仓库,会在当前目录产生.git
文件夹,这是保存着所有git操作所需要的文件,是本地进行git的第一步(远程克隆仓库不需要这一步)git add README.md
是将文件放入暂存区(stage),暂存区后面再说。git commit -m "first commit"
是记录这次的更改,-m
后的字符串则是更改详情,在你的github仓库中,你也会看到README.md
后面跟着"first commit"
这句话。git remote add origin git@github.com:FangYang970206/playground.git
是用来添加远程仓库的信息到本地,并用一个简短的引用来表示url,命令具体是git remote add <shortname> <url>
,也就是我们可以在接下来的git操作中,用origin
来代表整个url
,你也可以取你自己感兴趣的简短名字git push -u origin master
是将本地代码上传到github服务器,这句话要拆成两部分解释,第一部分是git push
,是上传命令,那上传到那里呢?第二部分-u origin master
则是指定上传位置,上传到origin
的master
分支,这里的-u
是设定默认主机,也就是下次你要是也上传到origin
的master
分支,就直接git push
就可以了仓库中的文件状态无非两种,一种是未被git跟踪(untracked),另一种是被git跟踪(tracked),对于从远程服务器中克隆出的仓库,默认全部文件都进行进行跟踪,而本地自己新建的仓库,则需要通过git add
命令将未被git跟踪的文件变为被git跟踪的文件。而被git跟踪的文件有三种状态,分别是未修改(unmodified)、未修改(modified)和暂存区(staged)。以5.1节的为例,我们先新建了README.md文件,这个文件处于未跟踪状态,然后初始化仓库后,我们通过git add
命令将未跟踪状态的文件转到跟踪状态,并将文件加入到暂存区。然后通过git commit
命令将暂存区状态转成未修改文件。下图形象地表示了文件地状态转换。
当你将文件转成跟踪状态时,文件如果没有人为移除,将一直处于跟踪状态,从未修改、已修改和暂存区三个状态反复转换,永不丢失。
上面的git add
和git commit
是最重要的两个命令,它是整个版本控制中最常用的两个命令,本地版本控制流程如下:
下面介绍一些git add
常用命令
git add <file> #添加单个文件
git add <dir_name> #添加整个文件夹
git add *.py #添加所有py文件
git add . #提交被修改的和新建的文件,但不包括被删除的文件
git add -A #提交所有变化
git add -h #git add帮助命令
然后介绍一下git commit
常用命令
git commit -m <message> #提交暂存区更改
git commit -am <message> #越过暂存区,不需要git add,直接提交所有tracked文件
git commit --amend #追加提交,不引入新的commit,追加到前一次commit,commit信息还可修改
git commit -h #更多commit命令
这里的git commit --amend
很有用,有时候我们提交时忘记了把一些文件加到暂存区一起提交,可又不想引入新的提交记录这次信息,就可以使用git commit --amend
,如下所示:
$ git commit -m 'initial commit'
$ git add forgotten_file
$ git commit --amend
执行git commit --amend
会打开编辑器(一般是vim),你可以修改提交说明(i进入插入模式修改),然后保存退出即可(Esc,然后shift+:,打wq,最后enter)
知道文件的状态,我们通过一些实例来学习一下。在playground仓库新建hello.py
,然后加入下面一行:
print("hello everyone")
git status
命令会显示当前仓库的文件状态,在终端中输入git status
,显示如下内容:
$ git status
On branch master
Your branch is up to date with 'origin/master'.
Untracked files:
(use "git add <file>..." to include in what will be committed)
hello.py
nothing added to commit but untracked files present (use "git add" to track)
可以看到我们刚刚新建的hello.py
处于untracked files。然后我们在终端中输入git add hello.py
,然后我们再次输入git status
,会出现下面内容:
$ git add hello.py
warning: LF will be replaced by CRLF in hello.py.
The file will have its original line endings in your working directory.
$ git status
On branch master
Your branch is up to date with 'origin/master'.
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
new file: hello.py
可以看到hello.py
的状态变为Changes to be committed
,这意味着hello.py
进入了暂存区,我们再用git commit
提交这次更改,然后再用git status
查看状态,结果如下:
$ git commit -m "add hello everyone"
[master 405cd1b] add hello everyone
1 file changed, 1 insertion(+)
create mode 100644 hello.py
$ git status
On branch master
Your branch is ahead of 'origin/master' by 1 commit.
(use "git push" to publish your local commits)
nothing to commit, working tree clean
可以看到显示nothing to commit
,文件状态处于未更改状态,因为我们完成了这一次版本的提交。最后我们可以使用git push
上传我们这次的提交到远程github服务器上。最后可以看到github的仓库中多了我们刚才修改的hello.py
.
git status
命令的输出可能过于模糊,如果你想知道具体修改了什么地方,可以用git diff
命令。它用来回答两个问题:当前做的哪些更新还没有暂存? 有哪些更新已经暂存起来准备好了下次提交?代码修改运行出错,有时候可以用git diff
,可以看到自己或他人新加入了那些行,有助于修复bug和多人合作。
我们在hello.py
文件再加入一行:
print("hello fang")
然后在终端中输入git diff
,结果如下:
$ git diff
warning: LF will be replaced by CRLF in hello.py.
The file will have its original line endings in your working directory.
diff --git a/hello.py b/hello.py
index 1ad4063..d469b07 100644
--- a/hello.py
+++ b/hello.py
@@ -1 +1,2 @@
print("hello everyone")
+print("hello yang")
+
号代表新添加的行,然后我们再加入一行:
print("hello fang")
然后再调用git diff
命令,结果如下:
$ git diff
diff --git a/hello.py b/hello.py
index 97d6fb2..2595b9c 100644
--- a/hello.py
+++ b/hello.py
@@ -1 +1,3 @@
print("hello everyone")
+print("hello yang")
+print("hello fang")
可以看到我们又多加了一行,我们将文件状态转到暂存区(使用git add hello.py
)看看,然后运行git diff
,可以看到是没有任何输出的,因为git diff
本身只显示尚未暂存的改动。如果想看暂存前后的变化,则需要使用git diff --cached
命令,则可以看到:
$ git diff --cached
diff --git a/hello.py b/hello.py
index 97d6fb2..2595b9c 100644
--- a/hello.py
+++ b/hello.py
@@ -1 +1,3 @@
print("hello everyone")
+print("hello yang")
+print("hello fang")
这里提一句,有时候我们运行git status
,我们会看到一个文件显示两种状态,比如我们上面加了一行print("hello FY")
,然后运行git status
,可以看到如下结果:
$ git status
On branch master
Your branch is ahead of 'origin/master' by 1 commit.
(use "git push" to publish your local commits)
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
modified: hello.py
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: hello.py
出现这种结果的原因是因为我们的文件确实存在两种状态,一种是我们之前加入到暂存区,一种是我们刚刚修改添加的,两者是可以共存的。
git log
命令会列出每个提交的SHA-1 校验和、作者的名字和电子邮件地址、提交时间以及提交说明。我们已经提交了许多次了,在bash中输入git log
,出现以下内容:
$ git log
commit a9b674c88eba0043f84aec4668215358f99c5572 (HEAD -> master)
Author: FangYang970206 <15270989505@163.com>
Date: Mon Aug 20 16:04:09 2018 +0800
add some info
commit 2ae267c61261b6041d16133cca56f4c8155d73fa
Author: FangYang970206 <15270989505@163.com>
Date: Mon Aug 20 10:02:57 2018 +0800
fix one error
commit 405cd1bd4b9e0d19f1698c7f7cb8f77184424040 (origin/master, origin/HEAD)
Author: FangYang970206 <15270989505@163.com>
Date: Sun Aug 19 21:49:29 2018 +0800
add hello everyone
commit edb1d60a14b25be099205a62a7c469083dc1338a
Author: FangYang970206 <15270989505@163.com>
Date: Fri Aug 17 17:41:25 2018 +0800
first commit
SHA-1校验和(也叫hash,哈希)这里提一句,在git中,文件的存储是通过文件内容计算哈希值(40位十六进制)进行索引的,所以不可能在git不知情的情况下修改文件,确保记录完备,提交更改会产生哈希值记录此次更改。
git log
其他常用命令:
git log -n #n是整数,返回最近n次提交历史
git log -p -n #用来显示每次提交的内容差异, -n则返回最近n次提交的差异
git log --stat #列出所有被修改过的文件、有多少文件被修改了以及被修改过的文件的哪些行被移除或是添加了。
git log --pretty=format #按照指定格式展示历史
git log --oneline --decorate #显示分支的指向情况,见分支的使用
git log --oneline --decorate --graph --all #输出提交历史、各个分支的指向以及项目的分支分叉情况。
个人觉得git log --pretty=format
非常有趣,可以很简洁展示历史,举例来说,我们在终端运行git log --pretty=format:"%h %s"
,有如下结果:
$ git log --pretty=format:"%h %s"
a9b674c add some info
2ae267c fix one error
405cd1b add hello everyone
edb1d60 first commit
第一项是简短哈希,第二项是提交说明,非常直观。常见的format如下。
git rm
命令用来删除文件,对文件不进行版本管理。git mv
命令可以对文件重命名和移动。
使用git rm
:
$ git rm README.md
rm 'README.md'
$ git status
On branch master
Your branch is ahead of 'origin/master' by 2 commits.
(use "git push" to publish your local commits)
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
deleted: README.md
$ git commit -m "delete README.md"
[master b976c0a] delete README.md
1 file changed, 1 deletion(-)
delete mode 100644 README.md
通过git rm
后,可以在playground文件夹中看到README.md文件已经不见了。
常用的git rm
命令有:
git rm -r <dirname> #递归删除文件夹中的文件
git rm \*.c #删除所有后缀.c文件
git rm -f filename #强制删除,针对修改并放到暂存区的文件
git rm --cached README #不删除文件,仍然放在目录中,但不进行跟踪
使用git mv
(先在playground文件夹新建dd文件夹):
$ git mv hello.py dd/hello.py
$ git status
On branch master
Your branch is ahead of 'origin/master' by 3 commits.
(use "git push" to publish your local commits)
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
renamed: hello.py -> dd/hello.py
$ git mv dd/hello.py dd/hello.txt
$ git status
On branch master
Your branch is ahead of 'origin/master' by 3 commits.
(use "git push" to publish your local commits)
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
renamed: hello.py -> dd/hello.txt
$ git commit -m "rename hello.py -> hello.txt"
git mv
相当于以下三条命令:
$ mv README.md README
$ git rm README.md
$ git add README
当然,能有简洁的命令当然用简洁的好!
这一节涉及到分支,建议跳过这一节,看完分支再过来。
git clone
是用来克隆远程仓库到本地;
git remote
是用来添加远程仓库,并为远程仓库添加名字缩写;
git push
是上传本地仓库到远程仓库中。
git fetch
是将远程仓库的更新下载到本地仓库中
git pull
是将远程仓库的更新下载到本地仓库中,并进行合并
克隆可以通过https url下载或者ssh url,命令很简单
$ git clone url
git remote add origin git@github.com:FangYang970206/playground.git
是用来添加远程仓库的信息到本地,并用一个简短的引用来表示url,命令具体是git remote add <shortname> <url>
,也就是我们可以在接下来的git操作中,用origin
来代表整个url
。
常用命令:
$ git remote -v #显示所有远程仓库的简写和url
git push -u origin master
是将本地代码上传到github服务器,这句话要拆成两部分解释,第一部分是git push
,是上传命令,那上传到那里呢?第二部分-u origin master
则是指定上传位置,上传到origin
的master
分支,这里的-u
是设定默认主机,也就是下次你要是也上传到origin
的master
分支,就直接git push
就可以了。
其他命令:
$ git push origin <source>:<destination> #来源和去向可不同
如果想把本地的foo分支推送到远程仓库中的bar分支,则可用这个命令进行指定。
git fetch
命令默认是将github中获取最新的版本到本地分支,默认是获取最新的origin/master,然后比较本地的master分支和origin/master分支的差别,进行差异合并。
更一般的命令:
$ git fetch origin <remote branch>:<local branch> #分支
git pull
命令是两个命令的合并
$ git pull origin <remote branch>:<local branch>
#equal
$ git fetch <remote branch>:<local branch>
$ git merge <remote branch> #on local branch
git reset
和git revert
命令是用来撤销变更的,常用命令如下(关于HEAD的解释,请看分支一节):
$ git reset #取消所有暂存文件
$ git reset HEAD <file> #取消某一暂存文件、
$ git reset HEAD~n #回溯n个提交
$ git reset --hard HEAD~n #强制回溯n个提交
$ git revert HEAD~n #新的提交与HEAD~(n+1)的内容一模一样
使用git reset
命令回溯到某个历史提交,不会保留后面的提交历史,而git revert
命令则是创建与回溯历史一样的提交。
有一个小技巧可以使你的 Git 体验更简单、容易、熟悉:别名。可以通过 git config文件来轻松地为每一个命令设置一个别名。以下是一些实例。
$ git config --global alias.co checkout
$ git config --global alias.br branch
$ git config --global alias.ci commit
$ git config --global alias.st status
这样,就可以用git co
代表git commit
,git br
代表git branch
等等。取消别名使可使用如下命令:
$ git config --global alias.unstage 'reset HEAD --'
Git 可以给历史中的某一个提交打上标签,以示重要。比较有代表性的是人们会使用这个功能来标记发布结点。经常可以看某些软件库经常发x.x.x版本。
$ git log --pretty=format:"%h %s"
b976c0a delete README.md
b4d7987 add some info
2ae267c fix one error
405cd1b add hello everyone
edb1d60 first commit
$ git tag v1 b976c0a
$ git push origin v1
通过以上命令,就可以在远程仓库tag下有v1版本,如图所示(ps:我多tag了一个v2):
一般我们总会有些文件无需纳入Git的管理,也不希望它们总出现在未跟踪文件列表。通常都是些自动生成的文件,比如日志文件,或者编译过程中创建的临时文件等。在这种情况下,我们可以创建一个名为.gitignore的文件,列出要忽略的文件模式。 文件.gitignore 的格式规范如下: • 所有空行或者以 # 开头的行都会被 Git 忽略。 • 可以使用标准的 glob 模式匹配。 • 匹配模式可以以(/)开头防止递归。 • 匹配模式可以以(/)结尾指定目录。 • 要忽略指定模式以外的文件或目录,可以在模式前加上惊叹号(!)取反。
所谓的 glob 模式是指 shell 所使用的简化了的正则表达式。 星号(*)匹配零个或多个任意字符;[abc] 匹配任何一个列在方括号中的字符(这个例子要么匹配一个a,要么匹配一个b,要么匹配一个c);问号(?)只匹配一个任意字符;如果在方括号中使用短划线分隔两个字符,表示所有在这两个字符范围内的都可以匹配(比如 [0-9] 表示匹配所有 0 到 9 的数字)。使用两个星号(*) 表示匹配任意中间目录,比如a/**/z可以匹配a/z, a/b/z 或 a/b/c/z等。
.gitignore 文件的例子:
# no .a files
*.a
# but do track lib.a, even though you're ignoring .a files above
!lib.a
# only ignore the TODO file in the current directory, not subdir/TODO
/TODO
# ignore all files in the build/ directory
build/
# ignore doc/notes.txt, but not doc/server/arch.txt
doc/*.txt
# ignore all .pdf files in the doc/ directory
doc/**/*.pdf
TIP: GitHub 有一个十分详细的针对数十种项目及语言的 .gitignore 文件列表,你可以在https://github.com/github/gitignore 找到它.
这一小节是最后加上的,可能会与后面的章节的LICENSE冲突,这点注意一下就好。
LICENSE文件是一种开源许可证,即授权条款。开源软件并非完全没有限制。最基本的限制,就是开源软件强迫任何使用和修改该软件的人承认发起人的著作权和所有参与人的贡献。任何人拥有可以自由复制、修改、使用这些源代码的权利,不得设置针对任何人或团体领域的限制;不得限制开源软件的商业使用等。而许可证就是这样一个保证这些限制的法律文件。
开源许可证有上百种,这里说说最流行的六种:GPL、BSD、MIT、Mozilla、Apache和LGPL如何做选择,阮一峰在如何选择开源许可证一文中给出了一张图,直观精确,就是下图:
那么如何给自己的仓库加上LICENSE呢?很简单,点击仓库中的creat new file,然后写LICENSE.md,选择choose a license template
然后选择MIT License,再点击Review and Submit,最后点击commit change就可以了。
我们就可以在自己仓库中看到MIT协议了
有人称分支是git的必杀技,正是因为这一特性,git从众多版本管理系统中脱颖而出。git鼓励多次使用分支和合并。精通分支,将对你的版本管理十分便捷和高效。进行分支之前,先讲git是如何保存数据的。
Note: 为了节省工作量,分支中有的图是截的书上的图,图中的校验和会与实际的校验和不同,这点注意一下就好。
与一些版本控制软件不同,Git保存的不是文件的变化或者差异,而是一系列不同时刻的文件快照。如下图所示
在进行提交操作时,Git 会保存一个提交对象(commit object)。知道了 Git 保存数据的方式,我们可以很自然的想到,该提交对象会包含一个指向暂存内容快照的指针。但不仅仅是这样,该提交对象还包含了作者的姓名和邮箱、提交时输入的信息以及指向它的父对象的指针。
首次提交产生的提交对象没有父对象,普通提交操作产生的提交对象有一个父对象,而由多个分支合并产生的提交对象有多个父对象。
为了更加形象地说明,我们假设现在有一个工作目录,里面包含了三个将要被暂存和提交的文件(文件需要自己动手在playground目录新建)。暂存操作会为每一个文件计算校验和,然后会把当前版本的文件快照保存到Git仓库中(Git使用blob对象来保存它们),最终将校验和加入到暂存区域等待提交:
$ git add README test.rb LICENSE
$ git commit -m 'branch note begin'
现在,Git仓库中有五个对象(忽略dd文件夹):三个blob对象(保存着文件快照)、一个树对象(记录着目录结构和blob对象索引)以及一个提交对象(包含着指向前述树对象的指针和所有提交信息)。具体结构如下图:
做些修改后再次提交(两次):
$ echo "print("1")" >> README
$ git commit -am "add print("1") into README"
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[master 326dd0b] add print(1) into README
1 file changed, 1 insertion(+)
$ echo "print("2")" >> README
$ git commit -am "add print("2") into README"
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[master ebc9b45] add print(2) into README
1 file changed, 1 insertion(+)
两次产生的提交对象会包含一个指向上次提交对象(父对象)的指针。见下图:
Git的分支,其实本质上仅仅是指向提交对象的可变指针。Git的默认分支名字是master。在多次提交操作之后,你其实已经有一个指向最后那个提交对象的master分支。它会在每次的提交操作中自动向前移动。
使用git branch
命令可以很简单地创建分支,比如创建一个testing分支。
$ git branch testing
这会在当前所在的提交对象上创建一个指针。如下图所示
那么,Git又是怎么知道当前在哪一个分支上呢?很简单,它有一个名为HEAD的特殊指针。这个特殊指针就是用来指定当前所在的分支。
可以使用git log
命令查看各个分支当前所指的对象。
$ git log --oneline --decorate -3 #只看倒数3个
ebc9b45 (HEAD -> master, testing) add print(2) into README
326dd0b add print(1) into README
b861d60 branch note begin
可以看到testing,master和现在指向master的HEAD都指向最后的提交。
创建好了分支,可以用git checkout
命令进行切换
$ git checkout testing
Switched to branch 'testing'
$ git branch #可以使用git branch查看当前分支(前面带*号)
master
* testing
有一个简单的命令可以快速创建新的分支并切换到新的分支:
$ git checkout -b new_branch
#等效于
$ git branch new_branch
$ git checkout new_branch
于是HEAD指针也发生了变化,如下图
在testing分支进行一次提交:
$ echo "print("3")" >> README
$ git commit -am "add print("3") into README"
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[testing 8b6bbb7] add print(3) into README
1 file changed, 1 insertion(+)
git的提交记录以及分支指向如下:
可以看到testing和HEAD都移动到前面了,而master没有移动。现在我们切换到master分支,对master进行一次提交。
$ echo "MIT LICENSE" >> LICENSE
$ git commit -am "add MIT LICENSE"
warning: LF will be replaced by CRLF in LICENSE.
The file will have its original line endings in your working directory.
[master ce53a90] add MIT LICENSE
1 file changed, 1 insertion(+)
提交后,上图就变成了下图
可以使用git log
命令查看提交历史
$ git log --oneline --decorate --graph --all -5 #只看倒数五个
* ce53a90 (HEAD -> master) add MIT LICENSE
| * 8b6bbb7 (testing) add print(3) into README
|/
* ebc9b45 add print(2) into README
* 326dd0b add print(1) into README
* b861d60 branch note begin
可以看到图中的看到结构与上图相同。 由于Git的分支实质上仅是包含所指对象校验和(长度为40的SHA-1值字符串)的文件,所以它的创建和销毁都异常高效,也就是添加或者删除41个字节的速度,能做到这一点的原因是因为git是以文件快照的形式保存文件,所以创建分支只需创建一个新的指针指向快照即可,而其他的一些版本管理软件往往需要将整个项目复制到另一个目录,这就比较慢了。
学了上面的东西,可能会想,为什么要使用分支?可以通过现实场景的问题来回答这个问题。
从个人角度,你正在开发一个网站,网站已经处于正常运行状态,我们想在网站中加入新的功能,这时候你有两种选择:一是直接在当前master上进行修改和测试,二是创建一个分支。选择一可能会产生影响正常工作的代码,这是我们不想看到的。而选择二创建分支可以很方便地解决这个问题,分支不会影响当前工作的分支,可以很放心地进行开发和测试,最后对原工作分支进行合并即可。
从多人协作角度上看,这个更加直接,在一条流水线上不仅效率低,而且会产生很多混乱,比如不同人代码水平有限,有的还会编写错误的代码,使用分支可以让软件维护者很方便地查看不同的分支情况,选择合适地分支进行合并。
另外,分支的创建是非常快的,只需创建一个新的指针即可,切换分支也非常地块,这可以让我们很灵活而不受干扰地工作。
分支整合可以通过两种命令:一种是基于git merge
命令,另一种是基于git rebase
命令。
git merge
是一种保存分支结构的合并,并且是三方合并,通过实例来看吧。
$ git merge testing #会跳出commit记录文件,默认退出即可
Merge made by the 'recursive' strategy.
README | 1 +
1 file changed, 1 insertion(+)
$ git log --oneline --decorate --graph --all -6
* f23a940 (HEAD -> master) Merge branch 'testing'
|\
| * 8b6bbb7 (testing) add print(3) into README
* | ce53a90 add MIT LICENSE
|/
* ebc9b45 add print(2) into README
* 326dd0b add print(1) into README
* b861d60 branch note begin
上面可以很直观地看出提交历史,用图形表示如下:
既然叫三方合并,是那三方呢?见下图
上图中浅蓝色方块就是三方,分别是当前分支,要合并的分支,以及这两者的共同祖先(这个由git自己决定),merge合并会根据当前分支与祖先的差异和要合并的分支与祖先的差异进行共同合并。
合并还有一种方法:那就是提取某一分支(8b6bbb7)中引入的补丁和修改,然后在另一分支(ce53a90)的基础上应用一次。在Git中,这种操作就叫做变基。可以使用 rebase命令将提交到某一分支上的所有修改都移至另一分支上,就好像“重新播放”一样。
$ git reset --hard ce53a90 #首先通过reset回溯到合并前的状态
HEAD is now at ce53a90 add MIT LICENSE
$ git log --oneline --decorate --graph --all -5
* ce53a90 (HEAD -> master) add MIT LICENSE
| * 8b6bbb7 (testing) add print(3) into README
|/
* ebc9b45 add print(2) into README
* 326dd0b add print(1) into README
* b861d60 branch note begin
$ git checkout testing #切换到要进行合并的分支
$ git rebase master #使用rebase命令将testing合并到master
First, rewinding head to replay your work on top of it...
Applying: add print(3) into README
$ git log --oneline --decorate --graph --all -5
* 972909a (HEAD -> testing) add print(3) into README
* ce53a90 (master) add MIT LICENSE
* ebc9b45 add print(2) into README
* 326dd0b add print(1) into README
* b861d60 branch note begin
通过git log
命令,整个历史可以看到没有想merge那样的分岔路,而是一条笔直的提交。rebase的原理是首先找到两个分支(即当前分支 testing、变基操作的目标基底分支master)的最近共同祖先,然后对比当前分支相对于该祖先的历次提交,提取相应的修改并存为临时文件,然后将当前分支指向目标基底master,最后以此将之前另存为临时文件的修改依序应用。之前分支出去的提交就没有了延续,不会出现在提交历史中了。可以用新的图来表示这个过程。
无论是通过三方merge合并,还是通过rebase变基,最后的结果是一样的,唯一不同的是提交历史的区别,merge还会保存分支的历史,而rebase则不会,它的提交历史是没有分叉的直线,相对整洁。
现在用commit id来简单表示校验和,你在主分支中的C2上创建了一个特性分支server,为服务端添加了一些功能,提交了C3和C4。然后从C3上创建了特性分支client,为客户端添加了一些功能,提交了C8和C9。最后,你回到server分支,又提交了C10。(ps:这里没有进行代码实践,有兴趣的朋友可以自己试试)
现在你希望将client中的修改合并到主分支并发布,但暂时并不想合并 server 中的修改,因为它们还需要经过更全面的测试。这时,你就可以使用git rebase命令的--onto选项,选中在client分支里但不在server分支里的修改(即C8和C9),将它们在master分支上重放:
$ git rebase --onto master server client
以上命令的意思是:“取出client分支,找出处于client分支和server分支的共同祖先之后的修改,然后把它们在 master分支上重放一遍”。效果如下:
然后进行快速合并,
$ git checkout master
$ git merge client
接下来你决定将server分支中的修改也整合进来。使用git rebase [basebranch] [topicbranch]
命令可以直接将特性分支(即本例中的server)变基到目标分支(即master)上。这样做能省去你先切换到
server 分支,再对其执行变基命令的多个步骤。
$ git rebase master server
结果如下:
最后我们进行快速合并以及删除server,client分支。
$ git checkout master
$ git merge server
$ git branch -d client
$ git branch -d client
最终的提交历史:
奇妙的变基也并非完美无缺,要用它得遵守一条准则:不要对在你的仓库外有副本的分支执行变基。否则,人民群众会仇恨你,你的朋友和家人也会嘲笑你,唾弃你
先简单说说这个意思,试想,A团队在本地进行了一次三方合并,然后push到远程服务器,B团队发现仓库有更改,通过git pull
将新的提交拉到本地进行合并。可不久,A团队想对发到远程服务器的版本做做变基,把上次的三方合并修改成了变基,再次push到远程服务器。B团队发送远程服务器版本又更新,而且自己上一次pull下来的一些提交不见了(rebase丢弃掉了),只好再次进行合并,但发现没有,A团队两次推送没有更改最后的提交内容,也就是说B团队合并了两次相同的提交(历史混乱,B团队尴尬),不仅如此,A团队是想清理掉一些提交历史的,但B团队还保留那些历史,等B团队push到远程服务器时,A团队看到自己rebase去掉的历史又出现了(A团队尴尬)。
这样说不太容易理解,下面通过图形进行描述。
此时如果你执行git log
命令,你会发现有两个提交的作者、日期、日志居然是一样的,这会令人感到混乱。此外,如果你将这一堆又推送到服务器上,你实际上是将那些已经被变基抛弃的提交又找了回来,这会令人感到更加混乱。 很明显对方并不想在提交历史中看到C4和C6,因为之前就是他把这两个提交通过变基丢弃的。
解决办法:用变基解决变基,执行git rebase teamone/master,Git将会
当然这个办法有一个前提,那就是C4'和C4要几乎一样,否则变基无法识别。还有一个缓解疼痛的方法,同git pull --rebase
替换git pull
,这个方法不会产生新的提交,也是变基。当然,最好的办法还是那条准则:不要对在你的仓库外有副本的分支执行变基!
当然在合并的过程中,可能会出现合并冲突的。合并冲突时,git merge
命令会显示是在哪个文件产生的冲突,我们来通过例子来试一试。
$ git checkout master #接着上面的git rebase
Switched to branch 'master'
Your branch is ahead of 'origin/master' by 4 commits.
(use "git push" to publish your local commits)
$ git merge testing
Updating ce53a90..972909a
Fast-forward
README | 1 +
1 file changed, 1 insertion(+)
$ git branch -d testing
Deleted branch testing (was 972909a).
$ git checkout -b newtesting
Switched to a new branch 'newtesting'
$ echo "print("newtesting")" >> README
$ git commit -am "Newtesting commit"
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[newtesting 1aaf545] Newtesting commit
1 file changed, 1 insertion(+)
$ git checkout master
Switched to branch 'master'
Your branch is ahead of 'origin/master' by 5 commits.
(use "git push" to publish your local commits)
$ echo "print("master")" >> README
$ git commit -am "master commit"
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[master 3883017] master commit
1 file changed, 1 insertion(+)
$ git merge newtesting
Auto-merging README
CONFLICT (content): Merge conflict in README
Automatic merge failed; fix conflicts and then commit the result.
可以看到最后出现了合并冲突,冲突出现在README文件中,我们需要打开文件看看冲突情况:
$ vi README
print(1)
print(2)
print(3)
<<<<<<< HEAD
print(master)
=======
print(newtesting)
>>>>>>> newtesting
为了解决冲突,你必须选择使用由=======分割的两部分中的一个,或者你也可以自行合并这些内容。我们选择print(master),从<<<<<<<
$ git add README
$ git status
On branch master
Your branch is ahead of 'origin/master' by 6 commits.
(use "git push" to publish your local commits)
All conflicts fixed but you are still merging.
(use "git commit" to conclude merge)
$ git commit -am "solve conflicts"
[master dc6b322] solve conflicts
$ git log --oneline --decorate --graph --all -8
* dc6b322 (HEAD -> master) solve conflicts
|\
| * 1aaf545 (newtesting) Newtesting commit
* | 3883017 master commit
|/
* 972909a add print(3) into README
* ce53a90 add MIT LICENSE
* ebc9b45 add print(2) into README
* 326dd0b add print(1) into README
* b861d60 branch note begin
还记得我们之前通过git push -u origin master
命令推送我们地仓库吗?最后推送的地址是origin/master
,这个叫做远程分支。其实在本地有一个origin/master
的指针,这个叫做远程跟踪分支,用来跟踪远程分支(最后一次沟通)的状态,这个指针所指向的位置不会随着本地操作而发生改变,而当使用git fetch
、git pull
等命令会随着远程仓库的状态而改变。而本地的master指针是会默认追踪origin/master
,这个追踪是从git clone
或者git remote add
那一刻起。
当你想要公开分享一个分支时,需要将其推送到有写入权限的远程仓库上。本地的分支并不会自动与远程仓库同步-你必须显式地推送想要分享的分支。这样,你就可以把不愿意分享的内容放到私人分支上,而将需要和别人协作的内容推送到公开分支。下面通过实例进行学习。
首先我们点开在GitHub创建的仓库——playground,然后如图所示,创建一个新分支testing,由于我已经创建,所以已经显示有testing分支。
我们在本地中使用git fetch
命令,将刚刚创建的分支下载到本地。
$ git fetch
From github.com:FangYang970206/playground
* [new branch] testing -> origin/testing
可以看到多出新的分支testing(本地分支)跟踪origin/master(远程跟踪分支)。我们通过git checkout <branch_name>
看到分支是否处于跟踪的状态。
$ git checkout master
Switched to branch 'master'
Your branch is up to date with 'origin/master'.
$ git checkout testing
Switched to a new branch 'testing'
Branch 'testing' set up to track remote branch 'testing' from 'origin'.
现在分别对testing和master分支做一次提交并push
$ echo "print("testing")" >> README
$ git commit -am README
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[testing f2466c5] README
1 file changed, 1 insertion(+)
$ git push origin testing
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 367 bytes | 183.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:FangYang970206/playground.git
dc6b322..f2466c5 testing -> testing
$ git checkout master
Switched to branch 'master'
Your branch is up to date with 'origin/master'.
$ echo "print("master1")" >> README
$ git commit -am README
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[master b849b25] README
1 file changed, 1 insertion(+)
$ git push origin master
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 360 bytes | 360.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:FangYang970206/playground.git
dc6b322..b849b25 master -> master
还可以更改其他本地指针来跟踪远程跟踪分支,下面通过实例来学习
$ git checkout -b foo origin/master
Switched to a new branch 'foo'
Branch 'foo' set up to track remote branch 'master' from 'origin'.
$ echo "# if" >> test.rb
$ git commit -am "commit test.rb"
warning: LF will be replaced by CRLF in test.rb.
The file will have its original line endings in your working directory.
[foo d3f4109] commit test.rb
1 file changed, 1 insertion(+)
$ git push origin HEAD:master
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 260 bytes | 86.00 KiB/s, done.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
To github.com:FangYang970206/playground.git
b849b25..d3f4109 HEAD -> master
$ git checkout testing
Switched to branch 'testing'
Your branch is up to date with 'origin/testing'.
$ git checkout -b testing1 origin/testing
Switched to a new branch 'testing1'
Branch 'testing1' set up to track remote branch 'testing' from 'origin'.
$ echo "print("testing1")" >> README
$ git commit -am "print testing1"
warning: LF will be replaced by CRLF in README.
The file will have its original line endings in your working directory.
[testing1 2600339] print testing1
1 file changed, 1 insertion(+)
$ git push origin HEAD:testing
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 373 bytes | 124.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:FangYang970206/playground.git
f2466c5..2600339 HEAD -> testing
$ git log --oneline --decorate --graph --all -9
* d3f4109 (origin/master, origin/HEAD, foo) commit test.rb
* b849b25 (master) README
| * 2600339 (HEAD -> testing1, origin/testing) print testing1
| * f2466c5 (testing) README
|/
* dc6b322 solve conflicts
|\
| * 1aaf545 Newtesting commit
* | 3883017 master commit
|/
* 972909a (newtesting) add print(3) into README
* ce53a90 add MIT LICENSE
可以看到之前跟踪远程跟踪分支的master和testing指针是没有移动,新建的foo和testing1取代了它们。这样要注意一点,使用不同于远程分支名的分支进行push,一定要指定当前分支,不然默认还是通过branch_name推送到origin/branch_name,出现Everything up-to-date,指定可以通过以上的HEAD(source):testing(target)
这里的取代方式可以有两种:一种是直接新建分支取代,也就是上面的git checkout -b testing1(newbranch) origin/testing(Remote tracking branch)
,还有一种是通过现在分支进行取代,可以通过git branch -u <Remote tracking branch> <existed branch>
命令,注意一点,不要出现远程跟踪分支和跟踪的指针出现分叉,这样会导致Your branch and 'origin/xxx' have diverged
这个问题,详细可参考这个链接。
强烈建议去https://learngitbranching.js.org/,这个网站有很多分支的练习,还有一部分是远程控制的练习,配合动画,非常适合正在学习git的朋友,相信可以让你的git本领上一个台阶。
如果你发现你感兴趣的仓库的bug或者你想添加某个新功能到你感兴趣的仓库中(一般是先在Issue中提出想法或问题,沟通好后可以在对应编号上创建pull re,这时候你就可以pull request这个沟通利器了(一般是先在Issue中提出想法或问题,沟通好后可以在对应编号上创建pull request)。
这里介绍一下一个仓库,可供你进行pull request练习,仓库地址是https://github.com/Data4Democracy/github-playground,当然,也欢迎你对本文的仓库https://github.com/FangYang970206/playground进行pull request,由于对自己的仓库进行pull request,本质上就是本地合并再提交,所以没有必要,完全可以在本地进行,pull request是以协作开发为目的,为了方便,对https://github.com/Data4Democracy/github-playground进行pull request,看本篇文章的朋友就可以随意选择两者之一。
pull request流程:
打开https://github.com/Data4Democracy/github-playground,点击Fork,等待副本仓库生成,复制下载url,使用git clone
到本地,然后在master分支下创建PR_practice分支,然后使用vi hello_test.py对文件进行修改,在后面添加一句print("PR practice, thanks"),然后Ese:wq保存后,再进行提交修改,最后push到origin/PR_practice分支就可以了,详细过程如下:
$ git clone git@github.com:FangYang970206/github-playground.git
Cloning into 'github-playground'...
remote: Counting objects: 230, done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 230 (delta 2), reused 4 (delta 1), pack-reused 221
Receiving objects: 100% (230/230), 307.80 KiB | 324.00 KiB/s, done.
Resolving deltas: 100% (85/85), done.
$ cd github-playground/
$ git checkout -b PR_practice
Switched to a new branch 'PR_practice'
$ vi hello_test.py
$ git add hello_test.py
$ git commit -m "add PR practice"
[PR_practice a874bdf] add PR practice
1 file changed, 1 insertion(+)
$ git push origin PR_practice
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 309 bytes | 309.00 KiB/s, done.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
To github.com:FangYang970206/github-playground.git
* [new branch] PR_practice -> PR_practice
我们再进入我们感兴趣的仓库地址,就会发现如下页面
我们点击旁边的compare&pull request或者直接点击New pull request,写一下标题和commit,然后creat pull request。
最后等待仓库拥有者审核,对这个pull request进行讨论,看是否要进行再修改等等。另外,每一个pull request都可以看files changed,可以看到有哪些行添加进去了,有哪些删除了,很是方便。
以上,就是一个pull request的流程,记得动手操作一遍。
最后,希望这篇文章能对看的朋友有所帮助,欢迎给这篇文章来个star。本文大量参考了Pro Git,建议读者可以去读一读这本git官网推荐的书籍。git-github-intro对git有一个不错大致简介。learngitbranching是一个非常不错的动手学习网站,推荐去动手学习,更多资源可以去参考trygit里面的内容。
我的博客即将搬运同步至腾讯云+社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan?invite_code=24bgt0s40480c