文章目录
- 简介
- 安装git
- 创建仓库
- 使用教程
- 版本回退
- 远程仓库
- GitHub
- 分支管理
- 修复bug的分支策略
- 多人协作
- 标签管理
简介
git:分布式版本控制系统
安装git
linux系统
# 首先查看是否已经安装git
git
The program 'git' is currently not installed. You can install it by typing:
# 根据以上命令完成安装,--Debian或Ubuntu Linux用以下命令安装
sudo apt-get install git
mac os 系统
# 通过homebrew安装
brew install git
# 或者下载 Xcode,Xcode中工具箱可以安装git
创建仓库
- step1 首先创建一个空目录
# 创建一个空目录
$ mkdir learngit
$ cd learngit
$ pwd
/Users/michael/learngit
- step 2 将目录初始化为Git 仓库
$ git init
# 初始化成功后,输出如下
Initialized empty Git repository in /Users/michael/learngit/.git/
初始化成功之后目录中多一个.git目录
将文件添加到版本库
在learngit
目录(或者其子目录)下新建文件readme.txt
- step1 将文件添加到仓库
git add readme.txt
- step2 提交文件,并用 -m 添加提交说明
git commit -m "wrote a readme file"
备注:可以多次add
不同的文件,commit
可以一次提交多个文件
$ git add file1.txt
$ git add file2.txt file3.txt
$ git commit -m "add 3 files."
使用教程
版本回退
查看版本控制系统的历史记录
git log
该命令显示从最近到最远的提交日志。
Git中的commit id
不是1、2、3,而是用十六进制表示的一个非常大的数字,如果所有人更新的版本id用1、2、3表示,会导致版本id 的冲突。
各版本表示
HEAD
:表示当前版本;
HEAD^
:表示上一个版本;
HEAD^^
:表示上上个版本;
HEAD~100
:表示前100个版本;
# 回退到上个版本
git reset --hard HEAD^
# 回到未来某个版本(利用版本号,只需要版本号前几位)
git reset --hard <版本号(前几位即可)>
Git的版本回退速度非常快,因为Git在内部有个指向当前版本的HEAD
指针,当你回退版本的时候,Git仅仅是把HEAD从指向当前版本改为指向指定版本。
git reflog
:记录每一次命令,可以在关闭git窗口后,查看历史命令,从而找到回退版本的id等信息;
git status
:查看暂存区(stage)的状态,也就是执行 git add
命令之后,commit之前的区域
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fWhFPDkC-1627285260775)(/Users/user/Library/Application%20Support/typora-user-images/image-20210723151023753.png)]
远程仓库
GitHub
配置SSH密钥
Github与本地仓库之间的传输是通过SSH方式加密的。
- 创建SSH密钥
用户主目录下,查看是否有 .ssh
目录,其中id_rsa
和id_rsa.pub
两个文件,id_rsa 存储私钥不能泄露,id_rsa.pub为公钥,可以告诉任何人。
- 在Github中设置SSH keys
在GitHub的账户设置中,打开“SSH Keys”页面,点击 “Add SSH key”, 在文本框内贴上id_rsa.pub
内的内容
连接远程仓库
首先在github创建一个新的仓库,然后在本地仓库的路径之下,执行以下命令
git remote add origin git@github.com:xxx/learngit.git
添加后,远程库的名字就是origin
,这是Git默认的叫法,也可以改成别的,但是origin
这个名字一看就知道是远程库。
将本地文件推送到远程库
首次推送本地仓库时,需要加上参数 -u,本地master
分支与远程新的master
分支关联
$ git push -u origin master
下次推送本地仓库时只需要执行
$ git push origin master
与远程库解除绑定关系
# 首先查看远程库的信息
git remote -v
# 根据名字解除远程库绑定关系
git remote rm origin
从远程仓库克隆
git clone git@github.com:michaelliao/gitskills.git
分支管理
基本命令
查看分支:git branch
创建分支:git branch <name>
切换分支:git checkout <name>
或者git switch <name>
创建+切换分支:git checkout -b <name>
或者git switch -c <name>
合并某分支到当前分支:git merge <name>
删除分支:git branch -d <name>
实例
- 创建
dev
分支
git branch dev
- 切换到
dev
分支
git checkout dev
以上两条命令相当于:
git checkout -b dev
- 查看当前分支
git branch
* dev
master
# 输出所有分支,当前分支前面有一个 *
在此分支中修改 reame.txt 文件,然后将该文件提交
git add readme.txt
git commit -m "branch test"
# 切换回master分支
git checkout master
切换回master
分支后,再查看一个readme.txt
文件,刚才添加的内容不见了!因为那个提交是在dev
分支上,而master
分支此刻的提交点并没有变。
- 合并分支
git merge dev
git merge
命令将指定的分支合并到当前的分支。
用git log --graph
命令可以看到分支合并图。
- 删除 dev 分支
git branch -d dev
修复bug的分支策略
情景:当需要修复一个bug,并且当前在dev上的工作还没有提交,不能通过直接重新创建一个分支来修复。
- 存储未完成工作
Git提供了一个stash
功能,可以把当前工作现场“储藏”起来,等以后恢复现场后继续工作。
$ git stash
Saved working directory and index state WIP on dev: f52c633 add merge
现在,用git status
查看工作区,就是干净的(除非有没有被Git管理的文件),因此可以放心地创建分支来修复bug。
- 创建修复bug的临时分支
# 切换回master分支
$ git checkout master
Switched to branch 'master'
Your branch is ahead of 'origin/master' by 6 commits.
(use "git push" to publish your local commits)
# 创建修复bug分支 issue-101
$ git checkout -b issue-101
Switched to a new branch 'issue-101'
- 修复bug,并提交
$ git add readme.txt
$ git commit -m "fix bug 101"
[issue-101 4c805e2] fix bug 101
1 file changed, 1 insertion(+), 1 deletion(-)
- 修复bug完成后,合并分支,并删除分支 issue-101
$ git switch master
Switched to branch 'master'
Your branch is ahead of 'origin/master' by 6 commits.
(use "git push" to publish your local commits)
$ git merge --no-ff -m "merged bug fix 101" issue-101
Merge made by the 'recursive' strategy.
readme.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
- 切换回dev分支,恢复之前的 stash 工作现场
$ git switch dev
Switched to branch 'dev'
# 查看工作区,是干净的,需要恢复之前保存的工作现场
$ git status
On branch dev
nothing to commit, working tree clean
# 查看之前的工作现场,发现存放在某个地方
$ git stash list
stash@{0}: WIP on dev: f52c633 add merge
# 恢复工作现场,继续开发,同时会删除之前保存的工作现场
$ git stash pop
On branch dev
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
new file: 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: readme.txt
Dropped refs/stash@{0} (5d677e2ee266f39ea296182fb2354265b91b3b2a)
# 或者使用以下命令,不会删除之前保存的 stash 工作现场
git stash apply
# 需要删除stash工作现场则使用以下命令
git stash pop
- 查看stash工作现场
$ git stash list
- 当有多个stash的时候,可以使用查看命令之后,恢复指定的stash
$ git stash apply stash@{0}
- 当前dev分支上的bug修复
在master分支上修复了bug后,我们要想一想,dev分支是早期从master分支分出来的,所以,这个bug其实在当前dev分支上也存在。
同样的bug,要在dev上修复,我们只需要把4c805e2 fix bug 101
这个提交所做的修改“复制”到dev分支。注意:我们只想复制4c805e2 fix bug 101
这个提交所做的修改,并不是把整个master分支merge过来。
为了方便操作,Git专门提供了一个cherry-pick
命令,让我们能复制一个特定的提交到当前分支。
$ git branch
* dev
master
$ git cherry-pick 4c805e2
[master 1d4b803] fix bug 101
1 file changed, 1 insertion(+), 1 deletion(-)
多人协作
当你从远程仓库克隆时,实际上Git自动把本地的master
分支和远程的master
分支对应起来了,并且,远程仓库的默认名称是origin
。
要查看远程库的信息,用git remote
:
$ git remote
origin
或者,用git remote -v
显示更详细的信息:
$ git remote -v
origin git@github.com:michaelliao/learngit.git (fetch)
origin git@github.com:michaelliao/learngit.git (push)
上面显示了可以抓取和推送的origin
的地址。如果没有推送权限,就看不到push的地址。
推送分支
推送分支,就是把该分支上的所有本地提交推送到远程库。推送时,要指定本地分支,这样,Git就会把该分支推送到远程库对应的远程分支上:
$ git push origin master
如果要推送其他分支,比如dev
,就改成:
$ git push origin dev
但是,并不是一定要把本地分支往远程推送,那么,哪些分支需要推送,哪些不需要呢?
-
master
分支是主分支,因此要时刻与远程同步; -
dev
分支是开发分支,团队所有成员都需要在上面工作,所以也需要与远程同步; -
bug
分支只用于在本地修复bug,就没必要推到远程了,除非老板要看看你每周到底修复了几个bug; -
feature
分支是否推到远程,取决于你是否和你的小伙伴合作在上面开发。
抓取分支
多人协作时,大家都会往master
和dev
分支上推送各自的修改。
现在,模拟一个你的小伙伴,可以在另一台电脑(注意要把SSH Key添加到GitHub)或者同一台电脑的另一个目录下克隆:
$ git clone git@github.com:michaelliao/learngit.git
Cloning into 'learngit'...
remote: Counting objects: 40, done.
remote: Compressing objects: 100% (21/21), done.
remote: Total 40 (delta 14), reused 40 (delta 14), pack-reused 0
Receiving objects: 100% (40/40), done.
Resolving deltas: 100% (14/14), done.
当你的小伙伴从远程库clone时,默认情况下,你的小伙伴只能看到本地的master
分支。不信可以用git branch
命令看看:
$ git branch
* master
现在,你的小伙伴要在dev
分支上开发,就必须创建远程origin
的dev
分支到本地,于是他用这个命令创建本地dev
分支:
$ git checkout -b dev origin/dev
现在,他就可以在dev
上继续修改,然后,时不时地把dev
分支push
到远程:
$ git add env.txt
$ git commit -m "add env"
[dev 7a5e5dd] add env
1 file changed, 1 insertion(+)
create mode 100644 env.txt
$ git push origin dev
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 308 bytes | 308.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:michaelliao/learngit.git
f52c633..7a5e5dd dev -> dev
你的小伙伴已经向origin/dev
分支推送了他的提交,而碰巧你也对同样的文件作了修改,并试图推送:
$ cat env.txt
env
$ git add env.txt
$ git commit -m "add new env"
[dev 7bd91f1] add new env
1 file changed, 1 insertion(+)
create mode 100644 env.txt
$ git push origin dev
To github.com:michaelliao/learngit.git
! [rejected] dev -> dev (non-fast-forward)
error: failed to push some refs to 'git@github.com:michaelliao/learngit.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
推送失败,因为你的小伙伴的最新提交和你试图推送的提交有冲突,解决办法也很简单,Git已经提示我们,先用git pull
把最新的提交从origin/dev
抓下来,然后,在本地合并,解决冲突,再推送:
$ git pull
There is no tracking information for the current branch.
Please specify which branch you want to merge with.
See git-pull(1) for details.
git pull <remote> <branch>
If you wish to set tracking information for this branch you can do so with:
git branch --set-upstream-to=origin/<branch> dev
git pull
也失败了,原因是没有指定本地dev
分支与远程origin/dev
分支的链接,根据提示,设置dev
和origin/dev
的链接:
$ git branch --set-upstream-to=origin/dev dev
Branch 'dev' set up to track remote branch 'dev' from 'origin'.
再pull:
$ git pull
Auto-merging env.txt
CONFLICT (add/add): Merge conflict in env.txt
Automatic merge failed; fix conflicts and then commit the result.
这回git pull
成功,但是合并有冲突,需要手动解决,解决的方法和分支管理中的解决冲突完全一样。解决后,提交,再push:
$ git commit -m "fix env conflict"
[dev 57c53ab] fix env conflict
$ git push origin dev
Counting objects: 6, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (6/6), 621 bytes | 621.00 KiB/s, done.
Total 6 (delta 0), reused 0 (delta 0)
To github.com:michaelliao/learngit.git
7a5e5dd..57c53ab dev -> dev
因此,多人协作的工作模式通常是这样:
- 首先,可以试图用
git push origin <branch-name>
推送自己的修改; - 如果推送失败,则因为远程分支比你的本地更新,需要先用
git pull
试图合并; - 如果合并有冲突,则解决冲突,并在本地提交;
- 没有冲突或者解决掉冲突后,再用
git push origin <branch-name>
推送就能成功!
如果git pull
提示no tracking information
,则说明本地分支和远程分支的链接关系没有创建,用命令git branch --set-upstream-to <branch-name> origin/<branch-name>
。
这就是多人协作的工作模式,一旦熟悉了,就非常简单。
小结
- 查看远程库信息,使用
git remote -v
; - 本地新建的分支如果不推送到远程,对其他人就是不可见的;
- 从本地推送分支,使用
git push origin branch-name
,如果推送失败,先用git pull
抓取远程的新提交; - 在本地创建和远程分支对应的分支,使用
git checkout -b branch-name origin/branch-name
,本地和远程分支的名称最好一致; - 建立本地分支和远程分支的关联,使用
git branch --set-upstream branch-name origin/branch-name
; - 从远程抓取分支,使用
git pull
,如果有冲突,要先处理冲突。
标签管理
创建标签
- 命令
git tag <tagname>
用于新建一个标签,默认为HEAD
,也可以指定一个commit id; - 命令
git tag -a <tagname> -m "blablabla..."
可以指定标签信息; - 命令
git tag
可以查看所有标签。
在Git中打标签非常简单,首先,切换到需要打标签的分支上:
$ git branch
* dev
master
$ git checkout master
Switched to branch 'master'
然后,敲命令git tag <name>
就可以打一个新标签:
$ git tag v1.0
可以用命令git tag
查看所有标签:
$ git tag
v1.0
默认标签是打在最新提交的commit上的。有时候,如果忘了打标签,比如,现在已经是周五了,但应该在周一打的标签没有打,怎么办?
方法是找到历史提交的commit id,然后打上就可以了:
$ git log --pretty=oneline --abbrev-commit
12a631b (HEAD -> master, tag: v1.0, origin/master) merged bug fix 101
4c805e2 fix bug 101
e1e9c68 merge with no-ff
f52c633 add merge
cf810e4 conflict fixed
5dc6824 & simple
14096d0 AND simple
b17d20e branch test
d46f35e remove test.txt
b84166e add test.txt
519219b git tracks changes
e43a48b understand how stage works
1094adb append GPL
e475afc add distributed
eaadf4e wrote a readme file
比方说要对add merge
这次提交打标签,它对应的commit id是f52c633
,敲入命令:
$ git tag v0.9 f52c633
再用命令git tag
查看标签:
$ git tag
v0.9
v1.0
注意,标签不是按时间顺序列出,而是按字母排序的。可以用git show <tagname>
查看标签信息:
$ git show v0.9
commit f52c63349bc3c1593499807e5c8e972b82c8f286 (tag: v0.9)
Author: Michael Liao <askxuefeng@gmail.com>
Date: Fri May 18 21:56:54 2018 +0800
add merge
diff --git a/readme.txt b/readme.txt
...
可以看到,v0.9
确实打在add merge
这次提交上。
还可以创建带有说明的标签,用-a
指定标签名,-m
指定说明文字:
$ git tag -a v0.1 -m "version 0.1 released" 1094adb
用命令git show <tagname>
可以看到说明文字:
$ git show v0.1
tag v0.1
Tagger: Michael Liao <askxuefeng@gmail.com>
Date: Fri May 18 22:48:43 2018 +0800
version 0.1 released
commit 1094adb7b9b3807259d8cb349e7df1d4d6477073 (tag: v0.1)
Author: Michael Liao <askxuefeng@gmail.com>
Date: Fri May 18 21:06:15 2018 +0800
append GPL
diff --git a/readme.txt b/readme.txt
...
标签操作
- 命令
git push origin <tagname>
可以推送一个本地标签; - 命令
git push origin --tags
可以推送全部未推送过的本地标签; - 命令
git tag -d <tagname>
可以删除一个本地标签; - 命令
git push origin :refs/tags/<tagname>
可以删除一个远程标签。