本文实践于 Learn Git Branching 这个有趣的 Git 学习网站。在该网站,可以使用 show command
命令展示所有可用命令。你也可以直接访问网站的sandbox,自由发挥。
一、本地篇
基础篇
git commit
git commit
将暂存区(staging area)的修改提交到本地版本库并创建一个新的提交,新提交会指向前一个提交,就像是链表一样的结构。
这里需要我们知道Git里的重要概念:工作区(working directory)、暂存区(staging area或index)和版本库(repository)。工作区即我们所见的项目文件夹。工作区中有个.git隐藏目录,这个是版本库,暂存区就位于版本库中,此外版本库中还有创建的分支以及指向当前分支的指针HEAD。分支实际上是个文件,但它完成的功能类似于一个指针。
git commit常用的结构:
$ git commit -m "C2"
直接运行git commit
会打开Git
默认编辑器。
git branch
git branch
用于分支管理,包括:
- 列出已有分支:git branch
- 创建新分支:git branch <branch>
- 删除分支:git branch -d <branch>
- 重命名分支:在本地重命名分支名:git branch -move <old-branch-name> <new-branch-name>,将这个修改同步到远程:git branch --set-upstream origin corrected <new-branch-name>
来创建一个名为newImage
的分支:
$ git branch newImage
补充:
main
分支是默认主分支,*
表示当前分支所在。我们的提交记录会提交到当前分支。
上图*
号依然位于main
,说明当前分支仍然是main
。
使用以下命令切换到新分支上:
$ git checkout newImage
Git 2.23 版本引入了
git switch <branch-name>
命令来取代git checkout
命令众多功能中的切换分支功能。
最后,git branch <branch-name>
和git checkout <branch-name>
可以合并为一条命令:
$ git checkout -b <branch-name>
git merge
git merge用于将一个或多个分支合并到当前分支上。在新建分支开发完新功能或修复完 Bug 后,我们可以将其合并回主分支。
合并bugFix
分支到main
分支:
$ git switch main
$ git merge bugFix
可以看到,合并分支时创建了新提交,这是非快进提交。接着,把main
分支合并到bugFix
:
$ git switch bugFix
$ git merge main
这是快进合并(Fast Forward)。
git rebase
git rebase
是另一种分支合并的方式,称为变基,具体是把一系列的提交记录复制到另一个地方。
使用git rebase
可以使得提交历史更加线性,因为git rebase可用于修剪git提交历史,而是否保存或删除原纪录,git rebase的交互模式中可以设置。
$ git rebase main
git rebase main
将当前分支(*
所在)bugFix
从与main
分支的公共祖先提交部分开始的提交记录复制到以main
分支的最新提交为起始的地方,但 复制不是真的复制,是解决冲突后的复制,如图复制后的C3'
提交已经与原提交C3
不同了。
git rebase main
中的main
就是基分支,当前分支bugFix
就是变基分支。
我们可以主动指定基分支和变基分支:git rebase main bugFix
。
高级篇:在提交树上移动
HEAD 简介与 HEAD 分离
HEAD 是一个指针,通常指向当前分支名,偶尔也会指向当前提交。
$ git checkout C1 # 切换到 C1 提交
$ git checkout main # 切换到 main
$ git commit -m "C2" # HEAD 指向的 main 指向 C2
$ git checkout C2 # 切换到 C2 提交
像git checkout C1
这样将 HEAD 指针指向提交C1
的行为称为 HEAD 分离(Detached HEAD)。分离前,HEAD 指向的是分支引用 main
。git checkout C1
中的C1
其实是提交的HASH
值。
查看提交记录的哈希值
$ git log
HASH 值很长,但我们只需要其前面几位可以唯一标识提交的即可,例如63dbb453f...
我们取63dbb
。
查看 HEAD 指向
$ git switch main
$ cat .git/HEAD
refs/heads/main
如果 HEAD 指向引用而非提交,也可以像下面查看 HEAD 指向:
$ git symbolic-ref HEAD
相对引用
前文使用 HASH 值来指定提交记录,这是直接引用,难免不方便,Git 提供了相对引用的方式来指定提交:
<branch>^
:branch
指向的提交的上一个提交。<branch>^^
:branch
指向的提交的前面第二个提交。<branch>~<num>
:branch
指向的提交前面第num
个提交。
$ git checkout main^ # 将HEAD指向main分支指向提交的前一个提交
强制修改分支位置
除了切换分支,相对引用用的最多的地方是移动分支。
$ git branch -f main HEAD~3 # 将main分支移动到HEAD指向提交的前第3个提交
如果要移动的分支不存在会自动创建。
撤销变更
git reset
git reset
命令将当前分支回退到直接引用或相对引用指向的提交记录,之后的提交记录就撤销了。
$ git reset HEAD^
C2
提交被reset
后,就不存在于本地版本库中,但是其变更还在,只不过处于未暂存状态。
git reset
只对本地分支有效,无法回退远程分支。
进行git reset
后,如果进行推送,Git 会提示远程仓库较新需要git pull
,但是git pull
后你的代码被远程仓库覆盖,如果想要回退生效,则需要追加-f
进行强制推送。
git revert
git revert
会创建新提交来撤销或恢复更改。这个要求你的working tree为空,即当前分支没有做新的修改。
$ git revert HEAD^^
如上图,我们恢复C1提交(HEAD^^
)为一个新提交。
移动提交记录
git cherry-pick
git chery-pick
用于把一些提交复制到当前提交(HEAD
)的下面。
$ git cherry-pick C2 C4
交互式 rebase
git rebase
后追加 --interactive
或 -i
选项会打开一个窗口(你配置的编辑器)显示将要被复制到目标分支的提交的哈希值和提交说明。
一个打开的示例窗口如下:
pick 63dbb45 2# Rebase 88e2af2..63dbb45 onto 88e2af2 (1 command)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup [-C | -c] <commit> = like "squash" but keep only the previous
# commit's log message, unless -C is used, in which case
# keep only this commit's message; -c is same as -C but
# opens the editor
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
# create a merge commit using the original merge commit's
# message (or the oneline, if no original merge commit was
# specified); use -c <commit> to reword the commit message
# u, update-ref <ref> = track a placeholder for the <ref> to be updated
# to this position in the new commits. The <ref> is
# updated at the end of the rebase
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
使用git rebase
经常会遇到要解决冲突的情况,解决冲突后,执行git add
和git rebase --continue
。解决冲突是在两种修改中手动选择一项或按需求地合并它们。
杂项
只复制一个提交
有时候,我们开发完一个功能,需要与主分支进行合并时,会希望只合并我想要的那个提交。
我们知道,使用git merge
的合并有快进合并和非快进合并两种。但是这两种合并会将我们不需要的提交也包含在主分支中。
这时候,我们可以使用git cherry-pick
或git rebase -i
来完成。
如上图,我想要将修复问题后的提交bugFix
合并到main
。
如果使用git merge
:
$ git checkout main
$ git merge bugFix
这使得主分支 main 中就包含了 C2、C3 这些提交。
使用git cherry-pick
:
$ git checkout main
$ git cherry-pick C4
$ git branch -f bugFix main
git tag
git tag
为提交记录打上标签,它可以像分支一样引用,但不会像分支一样移动。
$ git tag V1
$ git tag V2 C0
git describe
git describe
查找离指定引用最近的标签。
git describe main输出v1_2_gC2,git describe side输出v2_1_gC4。
git describe <ref>
的输出格式:<标签>_<数字>_g<提交的哈希值>
。数字的意思是从标签到指定提交的提交数量。
高级话题
多次 rebase
$ git checkout another
$ git rebase side
$ git rebase bugFix
$ git rebase main
$ git branch -f main another
相对引用^
中选择 parent 提交记录
相对引用^
可以像~
一样在后面加个数字,该数字表示选择第几个 parent 提交记录。^
后加数字直观上与 ~
加数字的区别是前者是横向,后者是纵向。
$ git checkout main^2
^
和~
的链式操作;
$ git checkout HEAD~^2~2
二、远程篇
Git 远程仓库基本操作
git clone
git clone命令用于从远程仓库(如Github、Gitee等)拷贝你需要的仓库。远程仓库可看作是你的本地仓库在另一台电脑上的拷贝。
$ git clone <远程仓库URL>
URL例子:https://github.com/dawnkylin/demo,这个URL采用了HTTP传输协议,除此之外,还可以使用git://或者使SSH协议的user@server:path/to/repo.git。
远程分支
上一节中的克隆产生的o/main
分支就是远程分支,o
是远程仓库名,一般是origin,图示使用简写代替。你使用git clone
克隆完一个仓库时,已经将远程仓库名设置为origin
了。
查看远程仓库信息:
$ git remote -v
修改远程仓库名:
$ git remote rename <远程仓库名>
远程分支反映了远程仓库的状态。
切换到远程分支会自动切换到 HEAD 分离状态。
$ git checkout o/main
git fetch
git fetch
从远程仓库下载缺失的提交记录,并更新远程分支。
$ git fetch <远程仓库URL>
git fetch
不会改变你的本地分支状态,也就是不会改变你的本地仓库文件。
示例:
执行git fetch后:
git pull
使用git fetch
只更新了远程分支,并未更新本地分支,还需要我们进行进一步合并,使用下面方法之一:
- git cherry-pick origin/main
- git merge origin/main
- git rebase origin/main
git pull
命令将拉取和合并操作结合在了一起,相当于git fetch
和git merge
的结合。
git push
git push
不带任何参数时的行为与 Git 的一个名为 push.default
的配置有关。
查看 push.default
值。
$ git config --get push.default
push.default
通常具有以下几种值:
simple
:这是 Git 2.0 及以后版本的默认值,它会将当前分支的 push 操作限制为其上游(通常是 origin 远程仓库)的同名分支。current
:将 push 操作限制为当前分支。nothing
:禁用默认的 push 行为,需要明确指定要 push 的分支和远程仓库。matching
:这是 Git 1.x 版本中的默认行为,它会将本地的所有分支与远程仓库的同名分支进行匹配,然后将它们都 push 到远程仓库。
修改 push.default
:
$ git config push.default <new_value>
偏离的提交历史
当你使用 git push
推送代码时,会遇到无法推送,要先与远程仓库合并的提示。这是由于远程仓库已经被你的同事修改了,你调用的 API 可能已经不存在或改名了,也就是发生了冲突。
如何解决冲突?
① 使用 git rebase
$ git fetch
$ git rebase o/main
$ git push o main
② 使用 git merge
$ git fetch
$ git merge o/main
$ git push o main
使用 git merge
会多一个合并提交。与git pull达到相同的结果。
③ 使用 git pull --rebase
,即 git fetch
与 git rebase
的结合
$ git pull --rebase
$ git push
Git 远程仓库高级操作
远程追踪
main
分支默认指定为跟踪远程分支 origin/main
,跟踪的意思是指定了 origin/main
为 push 的目的地和 fetch 后合并的目标。
如何自己设置分支跟踪远程分支?
方式一:
$ git checkout -b <local branch> <remote branch>
比如 git checkout -b foo origin/main
。
方式二:
$ git branch -u <remote branch> <local branch>
例如 git branch -u origin/main foo
,如果当前就在 foo 分支,还可以省略 foo
。
git push 的参数
实际 git push
的语法是:
$ git push <remote> <place>
意思是将 remote 的 place 分支没有的而本地 place 分支有的提交记录添加到 remote 的 place 分支。不仅会更新远程的 place 分支,也会更新本地的 remote/place 分支。
而 git push
没有参数时,会根据当前分支和它所追踪的远程分支来自动设置参数。
git push 的参数 2
将本地 source 分支推送到远程仓库的 destination 分支:
$ git push origin <source>:<destination>
准确地说,source 不一定是分支,也可能是标签、提交的 HASH 部分值和相对引用等等 Git 可以识别的位置。如果目的分支 destination 不存在,Git 会帮你自动创建的。
git fetch 的参数
$ git fetch origin foo
拉取远程仓库 origin 的远程分支 foo 的新提交,并放到本地的远程追踪分支 origin/foo 上,而不会影响 foo 分支。
也可以使用 <source>:<destination>
的参数格式:
$ git fetch origin foo~1:bar
上面命令的作用是将远程 foo 分支的上一个提交拉取到本地的 bar 分支上。
如果 bar 分支不存在就新建,这个和 git push 的参数行为是一致的。
没有指定参数的 git fetch 则会拉取所有提交记录。
source 参数为空的 git push 和 git fetch
1)git push orgin :foo
传空值 source 删除了远程的 foo 分支,连带着删除了本地的 origin/foo 分支。
2)git fetch origin :foo
则会在本地新创建一个 foo 分支。