分支管理 基本概念 一开始的时候,master
分支是一条线,Git用master
指向最新的提交,再用HEAD
指向master
,就能确定当前分支,以及当前分支的提交点:
1 2 3 4 5 6 7 8 9 10 11 HEAD │ │ ▼ master │ │ ▼ ┌───┐ ┌───┐ ┌───┐ │ │───▶│ │───▶│ │ └───┘ └───┘ └───┘
每次提交,master
分支都会向前移动一步,这样,随着你不断提交,master
分支的线也越来越长。
当我们创建新的分支,例如dev
时,Git新建了一个指针叫dev
,指向master
相同的提交,再把HEAD
指向dev
,就表示当前分支在dev
上:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 master │ │ ▼ ┌───┐ ┌───┐ ┌───┐ │ │───▶│ │───▶│ │ └───┘ └───┘ └───┘ ▲ │ │ dev ▲ │ │ HEAD
你看,Git创建一个分支很快,因为除了增加一个dev
指针,改改HEAD
的指向,工作区的文件都没有任何变化!
不过,从现在开始,对工作区的修改和提交就是针对dev
分支了,比如新提交一次后,dev
指针往前移动一步,而master
指针不变:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 master │ │ ▼ ┌───┐ ┌───┐ ┌───┐ ┌───┐ │ │───▶│ │───▶│ │───▶│ │ └───┘ └───┘ └───┘ └───┘ ▲ │ │ dev ▲ │ │ HEAD
假如我们在dev
上的工作完成了,就可以把dev
合并到master
上。Git怎么合并呢?最简单的方法,就是直接把master
指向dev
的当前提交,就完成了合并:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 HEAD │ │ ▼ master │ │ ▼ ┌───┐ ┌───┐ ┌───┐ ┌───┐ │ │───▶│ │───▶│ │───▶│ │ └───┘ └───┘ └───┘ └───┘ ▲ │ │ dev
所以Git合并分支也很快!就改改指针,工作区内容也不变!
合并完分支后,甚至可以删除dev
分支。删除dev
分支就是把dev
指针给删掉,删掉后,我们就剩下了一条master
分支:
1 2 3 4 5 6 7 8 9 10 11 HEAD │ │ ▼ master │ │ ▼ ┌───┐ ┌───┐ ┌───┐ ┌───┐ │ │───▶│ │───▶│ │───▶│ │ └───┘ └───┘ └───┘ └───┘
创建与合并分支 首先,我们创建dev
分支,然后切换到dev
分支:
1 2 $ git checkout -b dev Switched to a new branch 'dev'
git checkout <name>
切换分支创建分支:git branch <name>
切换分支:git checkout <name>
或者git switch <name>
创建+切换分支:git checkout -b <name>
或者git switch -c <name>
命令加上-b
参数表示创建并切换
相当于以下两条命令:
1 2 3 $ git branch dev$ git checkout devSwitched to branch 'dev'
用git branch
命令查看当前分支
git branch
命令会列出所有分支,当前分支前面会标一个*
号。
然后,我们就可以在dev
分支上正常提交,比如对readme.txt
做个修改,加上一行:
1 Creating a new branch is quick.
然后提交:
1 2 3 4 $ git add readme.txt $ git commit -m "branch test" [dev b17d20e ] branch test 1 file changed, 1 insertion(+)
现在,dev
分支的工作完成,我们就可以切换回master
分支:
1 2 $ git checkout master Switched to branch 'master '
切换回master
分支后,再查看一个readme.txt
文件,刚才添加的内容不见了!因为那个提交是在dev
分支上,而master
分支此刻的提交点并没有变:
git merge
命令用于合并指定分支到当前分支现在,我们把dev
分支的工作成果合并到master
分支上:
1 2 3 4 5 $ git merge devUpdating d46f35e..b17d20e Fast-forward readme.txt | 1 + 1 file changed, 1 insertion(+)
合并后,再查看readme.txt
的内容,就可以看到,和dev
分支的最新提交是完全一样的。
注意到上面的Fast-forward
信息,Git告诉我们,这次合并是“快进模式”,也就是直接把master
指向dev
的当前提交,所以合并速度非常快。
当然,也不是每次合并都能Fast-forward
,我们后面会讲其他方式的合并。
合并完成后,就可以放心地删除dev
分支了:
1 2 $ git branch -d dev Deleted branch dev (was b17d20e).
删除后,查看branch
,就只剩下master
分支了:
因为创建、合并和删除分支非常快,所以Git鼓励你使用分支完成某个任务,合并后再删掉分支,这和直接在master
分支上工作效果是一样的,但过程更安全。
小结 查看分支: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>
解决冲突 准备新的feature1
分支,继续我们的新分支开发:
1 2 $ git switch -c feature1 Switched to a new branch 'feature1'
修改readme.txt
最后一行,改为:
1 Creating a new branch is quick AND simple.
在feature1
分支上提交:
1 2 3 4 5 $ git add readme.txt $ git commit -m "AND simple" [feature1 14096d0] AND simple 1 file changed, 1 insertion (+), 1 deletion (-)
切换到master
分支:
1 2 3 4 $ git switch master Switched to branch 'master' Your branch is ahead of 'origin/master' by 1 commit . (use "git push" to publish your local commits)
Git还会自动提示我们当前master
分支比远程的master
分支要超前1个提交。
在master
分支上把readme.txt
文件的最后一行改为:
1 Creating a new branch is quick & simple.
提交:
1 2 3 4 $ git add readme.txt $ git commit -m "& simple" [master 5dc6824] & simple 1 file changed, 1 insertion (+), 1 deletion (-)
现在,master
分支和feature1
分支各自都分别有新的提交,变成了这样:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 HEAD │ │ ▼ master │ │ ▼ ┌───┐ ┌─▶│ │ ┌───┐ ┌───┐ ┌───┐ │ └───┘ │ │───▶│ │───▶│ │──┤ └───┘ └───┘ └───┘ │ ┌───┐ └─▶│ │ └───┘ ▲ │ │ feature1
这种情况下,Git无法执行“快速合并”,只能试图把各自的修改合并起来,但这种合并就可能会有冲突,我们试试看:
1 2 3 4 $ git merge feature1 Auto-merging readme.txtCONFLICT (content): Merge conflict in readme.txt Automatic merge failed; fix conflicts and then commit the result.
果然冲突了!Git告诉我们,readme.txt
文件存在冲突,必须手动解决冲突后再提交。git status
也可以告诉我们冲突的文件:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 $ git statusOn branch master Your branch is ahead of 'origin/master' by 2 commits. (use "git push" to publish your local commits) You have unmerged paths. (fix conflicts and run "git commit" ) (use "git merge --abort" to abort the merge ) Unmerged paths: (use "git add <file>..." to mark resolution) both modified: readme.txtno changes added to commit (use "git add" and/or "git commit -a" )
我们可以直接查看readme.txt的内容:
1 2 3 4 5 6 7 8 9 Git is a distributed version control system . Git is free software distributed under the GPL. Git has a mutable index called stage. Git tracks changes of files . <<<<<<< HEAD Creating a new branch is quick & simple. ======= Creating a new branch is quick AND simple. >>>>>>> feature1
Git用<<<<<<<
,=======
,>>>>>>>
标记出不同分支的内容,我们修改如下后保存:
1 Creating a new branch is quick and simple.
再提交:
1 2 3 $ git add readme.txt $ git commit -m "conflict fixed" [master cf810e4] conflict fixed
现在,master
分支和feature1
分支变成了下图所示:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 HEAD │ │ ▼ master │ │ ▼ ┌───┐ ┌───┐ ┌─▶│ │───▶│ │ ┌───┐ ┌───┐ ┌───┐ │ └───┘ └───┘ │ │───▶│ │───▶│ │──┤ ▲ └───┘ └───┘ └───┘ │ ┌───┐ │ └─▶│ │──────┘ └───┘ ▲ │ │ feature1
用带参数的git log
可以看到分支的合并情况 1 2 3 4 5 6 7 8 9 10 11 12 13 14 $ git log --graph --pretty=oneline --abbrev-commit |\ | * 14096 d0 (feature1) AND simple |/
分支管理策略 通常,合并分支时,如果可能,Git会用Fast forward
模式,但这种模式下,删除分支后,会丢掉分支信息。
如果要强制禁用Fast forward
模式,Git就会在merge时生成一个新的commit,这样,从分支历史上就可以看出分支信息。
git merge --no-ff -m "merge with no-ff" dev
用普通模式合并合并dev
分支,请注意--no-ff
参数,表示禁用Fast forward
:
1 2 3 4 $ git merge --no-ff -m "merge with no-ff" devMerge made by the 'recursive' strategy. readme.txt | 1 + 1 file changed, 1 insertion (+)
因为本次合并要创建一个新的commit,所以加上-m
参数,把commit描述写进去。
合并后,我们用git log
看看分支历史:
1 2 3 4 5 6 7 $ git log * e1e9c68 (HEAD -> master) merge with no-ff |\ | * f52c633 (dev) add merge |/ * cf810e4 conflict fixed ...
可以看到,不使用Fast forward
模式,merge后就像这样:
团队合作中 在实际开发中,我们应该按照几个基本原则进行分支管理:
首先,master
分支应该是非常稳定的,也就是仅用来发布新版本,平时不能在上面干活;
那在哪干活呢?干活都在dev
分支上,也就是说,dev
分支是不稳定的,到某个时候,比如1.0版本发布时,再把dev
分支合并到master
上,在master
分支发布1.0版本;
你和你的小伙伴们每个人都在dev
分支上干活,每个人都有自己的分支,时不时地往dev
分支上合并就可以了。
所以,团队合作的分支看起来就像这样:
小结 Git分支十分强大,在团队开发中应该充分应用。
合并分支时,加上--no-ff
参数就可以用普通模式合并,合并后的历史有分支,能看出来曾经做过合并,而fast forward
合并就看不出来曾经做过合并。
bug分支 每个bug都可以通过一个新的临时分支来修复,修复后,合并分支,然后将临时分支删除。
git stash
保存工作现场在bug修复后继续工作
Git还提供了一个stash
功能,可以把当前工作现场“储藏”起来,等以后恢复现场后继续工作:
1 2 $ git stash Saved working directory and index state WIP on dev: f52c633 add merge
现在,用git status
查看工作区,就是干净的(除非有没有被Git管理的文件),因此可以放心地创建分支来修复bug。
1 2 $ git stash Saved working directory and index state WIP on dev: f52c633 add merge
git checkout -b issue-101
在主分支上创建修复用的临时分支首先确定要在哪个分支上修复bug,假定需要在master
分支上修复,就从master
创建临时分支:
1 2 3 4 5 6 7 $ 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) $ git checkout -b issue-101 Switched to a new branch 'issue-101'
现在修复bug,然后提交:
1 2 3 4 $ git add readme.txt $ git commit -m "fix bug 101" [issue-101 4c805e2] fix bug 101 1 file changed, 1 insertion (+), 1 deletion (-)
修复完成后,切换到master
分支,并完成合并,最后删除issue-101
分支:
1 2 3 4 5 6 7 8 9 $ 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 Merge made by the 'recursive' strategy. readme.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
太棒了,原计划两个小时的bug修复只花了5分钟!现在,是时候接着回到dev
分支干活了!
1 2 3 4 5 6 $ git switch dev Switched to branch 'dev' $ git statusOn branch devnothing to commit , working tree clean
工作区是干净的,刚才的工作现场存到哪去了?用git stash list
命令看看:
1 2 $ git stash list stash@{0}: WIP on dev: f52c633 add merge
工作现场还在,Git把stash内容存在某个地方了,但是需要恢复一下,有两个办法:
一是用git stash apply
恢复,但是恢复后,stash内容并不删除,你需要用git stash drop
来删除;
另一种方式是用git stash pop
,恢复的同时把stash内容也删了:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 $ 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 } (5 d677e2ee266f39ea296182fb2354265b91b3b2a)
再用git stash list
查看,就看不到任何stash内容了:
你可以多次stash,恢复的时候,先用git stash list
查看,然后恢复指定的stash,用命令:
1 $ git stash apply stash@ {0 }
在master分支上修复了bug后,我们要想一想,dev分支是早期从master分支分出来的,所以,这个bug其实在当前dev分支上也存在。
那怎么在dev分支上修复同样的bug?
同样的bug,要在dev上修复,我们只需要把4c805e2 fix bug 101
这个提交所做的修改“复制”到dev分支。注意:我们只想复制4c805e2 fix bug 101
这个提交所做的修改,并不是把整个master分支merge过来。
git cherry-pick
复制特定的提交到当前分支为了方便操作,Git专门提供了一个cherry-pick
命令,让我们能复制一个特定的提交到当前分支:
1 2 3 4 5 6 $ git branch * dev master $ git cherry-pick 4 c805e2 [master 1d4b803 ] fix bug 101 1 file changed, 1 insertion(+), 1 deletion(-)
Git自动给dev分支做了一次提交,注意这次提交的commit是1d4b803
,它并不同于master的4c805e2
,因为这两个commit只是改动相同,但确实是两个不同的commit。用git cherry-pick
,我们就不需要在dev分支上手动再把修bug的过程重复一遍。
有些聪明的童鞋会想了,既然可以在master分支上修复bug后,在dev分支上可以“重放”这个修复过程,那么直接在dev分支上修复bug,然后在master分支上“重放”行不行?当然可以,不过你仍然需要git stash
命令保存现场,才能从dev分支切换到master分支。
小结 修复bug时,我们会通过创建新的bug分支进行修复,然后合并,最后删除;
当手头工作没有完成时,先把工作现场git stash
一下,然后去修复bug,修复后,再git stash pop
,回到工作现场;
在master分支上修复的bug,想要合并到当前dev分支,可以用git cherry-pick <commit>
命令,把bug提交的修改“复制”到当前分支,避免重复劳动
feature分支 软件开发中,总有无穷无尽的新的功能要不断添加进来。
添加一个新功能时,你肯定不希望因为一些实验性质的代码,把主分支搞乱了,所以,每添加一个新功能,最好新建一个feature分支,在上面开发,完成后,合并,最后,删除该feature分支。
现在,你终于接到了一个新任务:开发代号为Vulcan的新功能,该功能计划用于下一代星际飞船。
于是准备开发:
1 2 $ git switch -c feature-vulcan Switched to a new branch 'feature-vulcan'
5分钟后,开发完毕:
1 2 3 4 5 6 7 8 9 10 11 12 13 $ git add vulcan.py $ git status On branch feature-vulcan Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file : vulcan.py $ git commit -m "add feature vulcan" [feature-vulcan 287773 e ] add feature vulcan 1 file changed, 2 insertions(+) create mode 100644 vulcan.py
切回dev
,准备合并:
一切顺利的话,feature分支和bug分支是类似的,合并,然后删除。
git branch -D branchname
强行删除未提交分支1 2 3 $ git branch -d feature-vulcanerror: The branch 'feature-vulcan' is not fully merged. If you are sure you want to delete it, run 'git branch -D feature-vulcan'.
销毁失败。Git友情提醒,feature-vulcan
分支还没有被合并,如果删除,将丢失掉修改,如果要强行删除,需要使用大写的-D
参数。。
现在我们强行删除:
1 2 $ git branch -D feature -vulcan Deleted branch feature -vulcan (was 287773 e).
终于删除成功!
多人协作 用git remote
查看远程库的信息
或者,用git remote -v
显示更详细的信息:
1 2 3 $ git remote -v origin git@github .com :michaelliao/learngit.git (fetch) origin git@github .com :michaelliao/learngit.git (push)
上面显示了可以抓取和推送的origin
的地址。如果没有推送权限,就看不到push的地址。
git push origin name
推送分支推送分支,就是把该分支上的所有本地提交推送到远程库。推送时,要指定本地分支,这样,Git就会把该分支推送到远程库对应的远程分支上:
1 $ git push origin master
如果要推送其他分支,比如dev
,就改成:
但是,并不是一定要把本地分支往远程推送,那么,哪些分支需要推送,哪些不需要呢?
master
分支是主分支,因此要时刻与远程同步;
dev
分支是开发分支,团队所有成员都需要在上面工作,所以也需要与远程同步;
bug分支只用于在本地修复bug,就没必要推到远程了,除非老板要看看你每周到底修复了几个bug;
feature分支是否推到远程,取决于你是否和你的小伙伴合作在上面开发。
抓取分支 多人协作时,大家都会往master
和dev
分支上推送各自的修改。
现在,模拟一个你的小伙伴,可以在另一台电脑(注意要把SSH Key添加到GitHub)或者同一台电脑的另一个目录下克隆:
1 2 3 4 5 6 7 $ 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 checkout -b dev origin/dev
抓取多个分支现在,你的小伙伴要在dev
分支上开发,就必须创建远程origin
的dev
分支到本地,于是他用这个命令创建本地dev
分支:
1 $ git checkout -b dev origin/dev
同步分支 现在,他就可以在dev
上继续修改,然后,时不时地把dev
分支push
到远程:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 $ git add env.txt$ git commit -m "add env" [dev 7 a5e5dd] 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 Writing objects: 100 Total 3 (delta 0 ), reused 0 (delta 0 ) To github.com:michaelliao/learngit.git f52c633..7 a5e5dd dev -> dev
推送失败,因为你的小伙伴的最新提交和你试图推送的提交有冲突,解决办法也很简单,Git已经提示我们,先用git pull
把最新的提交从origin/dev
抓下来,然后,在本地合并,解决冲突,再推送:
1 2 3 4 5 6 7 8 9 10 $ 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
的链接:
1 2 $ git branch --set-upstream-to =origin/dev dev Branch 'dev' set up to track remote branch 'dev' from 'origin' .
再pull:
1 2 3 4 $ git pull Auto-merging env.txtCONFLICT (add /add ): Merge conflict in env.txt Automatic merge failed; fix conflicts and then commit the result.
这回git pull
成功,但是合并有冲突,需要手动解决,解决的方法和分支管理中的解决冲突 完全一样。解决后,提交,再push:
1 2 3 4 5 6 7 8 9 10 11 $ git commit -m "fix env conflict" [dev 57 c53ab] 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 7 a5e5dd..57 c53ab dev -> dev
git rebase
把本地未push的分叉提交历史整理成直线rebase操作可以把本地未push的分叉提交历史整理成直线;
rebase的目的是使得我们在查看历史提交的变化时更容易,因为分叉的提交需要三方对比。
总结 多人协作的工作模式通常是这样:
首先,可以试图用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
,如果有冲突,要先处理冲突。
1 2 3 4 5 6 7 8 9 10 11 12 $ git rebase First, rewinding head to replay your work on top of it... Applying: add comment Using index info to reconstruct a base tree... M hello.py Falling back to patching base and 3 -way merge... Auto-merging hello.py Applying: add author Using index info to reconstruct a base tree... M hello.py Falling back to patching base and 3 -way merge... Auto-merging hello.py
输出了一大堆操作,到底是啥效果?再用git log
看看:
1 2 3 4 5 6 $ git log --graph --pretty=oneline --abbrev-commit * 7 e61ed4 (HEAD -> master) add author * 3611 cfe add comment * f005ed4 (origin/master) set exit =1 * d1be385 init hello ...
原本分叉的提交现在变成一条直线了!这种神奇的操作是怎么实现的?其实原理非常简单。我们注意观察,发现Git把我们本地的提交“挪动”了位置,放到了f005ed4 (origin/master) set exit=1
之后,这样,整个提交历史就成了一条直线。rebase操作前后,最终的提交内容是一致的,但是,我们本地的commit修改内容已经变化了,它们的修改不再基于d1be385 init hello
,而是基于f005ed4 (origin/master) set exit=1
,但最后的提交7e61ed4
内容是一致的。
这就是rebase操作的特点:把分叉的提交历史“整理”成一条直线,看上去更直观。缺点是本地的分叉提交已经被修改过了。
最后,通过push操作把本地分支推送到远程:
1 2 3 4 5 6 7 8 9 Mac :~/learngit michael$ git push origin masterCounting objects: 6 , done.Delta compression using up to 4 threads.Compressing objects: 100 % (5 /5 ), done.Writing objects: 100 % (6 /6 ), 576 bytes | 576 .00 KiB/s, done.Total 6 (delta 2 ), reused 0 (delta 0 )remote : Resolving deltas: 100 % (2 /2 ), completed with 1 local object.To github.com:michaelliao/learngit.git f005ed4 ..7 e61ed4 master -> master
再用git log
看看效果:
1 2 3 4 5 6 $ git log --graph --pretty=oneline --abbrev-commit * 7 e61ed4 (HEAD -> master, origin/master) add author * 3611 cfe add comment * f005ed4 set exit =1 * d1be385 init hello ...
远程分支的提交历史也是一条直线
标签管理 发布一个版本时,我们通常先在版本库中打一个标签(tag),这样,就唯一确定了打标签时刻的版本。将来无论什么时候,取某个标签的版本,就是把那个打标签的时刻的历史版本取出来。所以,标签也是版本库的一个快照。
Git的标签虽然是版本库的快照,但其实它就是指向某个commit的指针(跟分支很像对不对?但是分支可以移动,标签不能移动),所以,创建和删除标签都是瞬间完成的。
标签是指向commit的死指针 ,分支是指向commit的活指针
tag就是一个让人容易记住的有意义的名字,它跟某个commit绑在一起
git tag <name>
创建标签首先,切换到需要打标签的分支上:
1 2 3 4 5 $ git branch * dev master $ git checkout master Switched to branch 'master '
然后,敲命令git tag <name>
就可以打一个新标签:
可以用命令git tag
查看所有标签:
默认标签是打在最新提交的commit上的。有时候,如果忘了打标签,比如,现在已经是周五了,但应该在周一打的标签没有打,怎么办?
方法是找到历史提交的commit id,然后打上就可以了:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 $ git log 12 a631b (HEAD -> master, tag: v1.0 , origin/master) merged bug fix 101 4 c805e2 fix bug 101 e1e9c68 merge with no -ff f52c633 add merge cf810e4 conflict fixed5 dc6824 & simple14096 d0 AND simple b17d20e branch test d46f35e remove test.txt b84166e add test.txt519219 b git tracks changes e43a48b understand how stage works1094 adb append GPL e475afc add distributed eaadf4e wrote a readme file
比方说要对add merge
这次提交打标签,它对应的commit id是f52c633
,敲入命令:
再用命令git tag
查看标签:
注意,标签不是按时间顺序列出,而是按字母排序的。可以用git show <tagname>
查看标签信息:
1 2 3 4 5 6 7 8 9 $ 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 ...
可以看到,v0.9
确实打在add merge
这次提交上。
还可以创建带有说明的标签,用-a
指定标签名,-m
指定说明文字:
1 $ git tag -a v0.1 -m "version 0.1 released" 1094 adb
用命令git show <tagname>
可以看到说明文字:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 $ 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 1094 adb7b9b3807259d8cb349e7df1d4d6477073 (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 ...
注意:标签总是和某个commit挂钩。如果这个commit既出现在master分支,又出现在dev分支,那么在这两个分支上都可以看到这个标签。
操作标签 如果标签打错了,也可以删除:
1 2 $ git tag -d v0.1 Deleted tag 'v0 .1 ' (was f15b0dd)
因为创建的标签都只存储在本地,不会自动推送到远程。所以,打错的标签可以在本地安全删除。
如果要推送某个标签到远程,使用命令git push origin <tagname>
:
1 2 3 4 $ git push origin v1.0 Total 0 (delta 0 ), reused 0 (delta 0 ) To github.com:michaelliao/learngit.git * [new tag] v1.0 -> v1.0
或者,一次性推送全部尚未推送到远程的本地标签:
1 2 3 4 $ git push origin --tags Total 0 (delta 0 ), reused 0 (delta 0 ) To github.com:michaelliao/learngit.git * [new tag] v0.9 -> v0.9
如果标签已经推送到远程,要删除远程标签就麻烦一点,先从本地删除:
1 2 $ git tag -d v0.9 Deleted tag 'v0 .9 ' (was f52c633)
然后,从远程删除。删除命令也是push,但是格式如下:
1 2 3 $ git push origin :refs/tags/v0 .9 To github.com: michaelliao/learngit.git - [deleted] v0.9
要看看是否真的从远程库删除了标签,可以登陆GitHub查看。