Git命令进阶
Git 命令进阶 - 经典操作场景
1. 提交操作(commit)
1.1. 查看提交的历史
如果使用 git commit -a
提交了一次变化(changes),而又不确定到底这次提交了哪些内容。此时就可以用下面的命令显示当前 HEAD 上的最近一次的提交(commit):
1 | git show |
1.2. 修改提交信息(commit message)
如果提交信息(commit message
)写错了且这次提交(commit)还没有推送(push),可以通过下面的方法来修改提交信息(commit message
):
1 | $ git commit --amend --only |
再次打开默认编辑器, 在这里可以重新编辑信息。另外也可以用以下一条命令一次完成:
1 | $ git commit --amend --only -m 'xxxxxxx' |
如果已经推送(push)了这次提交(commit),则可以修改这次提交(commit)然后强推(force push
),但是不推荐这么做。
1.3. 修改提交(commit)里的用户名和邮箱
如果只是单个提交(commit),则通过以下命令修改:
1 | $ git commit --amend --author "New Authorname <authoremail@mydomain.com>" |
如果需要修改所有历史,参考 ‘git filter-branch’的指南页.
1.4. 从一个提交(commit)里移除一个文件
通过下面的方法,从一个提交(commit)里移除一个文件:
1 | $ git checkout HEAD^ myfile |
这将非常有用,当有一个开放的补丁(open patch
),往上面提交了一个不必要的文件,需要强推(force push
)去更新这个远程补丁。
1.5. 删除最后一次提交(commit)
如果需要删除已推送了的提交(pushed commits
),可以使用下面的方法。可是,这会不可逆的改变提交的历史,也会搞乱那些已经从该仓库拉取(pulled)了的人的历史。简而言之,如果不是很确定,千万不要这么做。
1 | $ git reset HEAD^ --hard |
如果还没有推送到远程,把 Git 重置(reset)到最后一次提交前的状态就可以了(同时保存暂存的变化):
1 | (my-branch*)$ git reset --soft HEAD@{1} |
以上只能用在没有推送之前。如果已经推送了,唯一安全能做的是 git revert SHAofBadCommit
, 那会创建一个新的提交(commit)用于撤消前一个提交的所有变化(changes);或者如果推送的这个分支是 rebase-safe 的 (例如:其它开发者不会从这个分支拉取),则只需要使用 git push -f
。
1.6. 删除任意提交(commit)
Notes: 同样的警告,不到万不得已的时候不要这么做。
1 | $ git rebase --onto SHA1_OF_BAD_COMMIT^ SHA1_OF_BAD_COMMIT |
或者做一个 交互式 rebase 删除那些想要删除的提交(commit)里所对应的行。
1.7. 尝试推一个修正后的提交(amended commit)到远程,但是报错:
1 | To https://github.com/yourusername/repo.git |
注意,rebasing(见下面)和修正(amending)会用一个新的提交(commit)代替旧的,所以如果之前已经往远程仓库上推过一次修正前的提交(commit),那现在就必须强推(force push
) (-f
)。注意总是确保指明一个分支!
1 | (my-branch)$ git push origin mybranch -f |
一般来说,要避免强推。最好是创建和推(push)一个新的提交(commit),而不是强推一个修正后的提交。后者会使那些与该分支或该分支的子分支工作的开发者,在源历史中产生冲突。
1.8. 做了一次硬重置(hard reset),想找回之前内容
如果意外的做了 git reset --hard
,通常能找回之前提交(commit),因为 Git 对每件事都会有日志,且都会保存几天。
1 | (main)$ git reflog |
将会看到一个过去提交(commit)的列表和一个重置的提交。选择想要回到的提交(commit)的 SHA,再重置一次:
1 | (main)$ git reset --hard SHA1234 |
2. 暂存(Staging)
2.1. 把暂存的内容添加到上一次的提交(commit)
1 | (my-branch*)$ git commit --amend |
2.2. 暂存一个新文件的一部分,而不是这个文件的全部
如果想暂存一个文件的一部分,可这样做:
1 | $ git add --patch filename.x |
-p
简写。这会打开交互模式,将能够用 s
选项来分隔提交(commit);然而如果这个文件是新的,会没有这个选择,添加一个新文件时可以使用以下操作:
1 | $ git add -N filename.x |
然后需要使用 e
选项来手动选择需要添加的行,执行 git diff --cached
将会显示哪些行暂存了哪些行只是保存在本地了。
2.3. 在一个文件里的变化(changes)加到两个提交(commit)里
git add
会把整个文件加入到一个提交;git add -p
允许交互式的选择想要提交的部分。
2.4. 把暂存的内容变成未暂存,把未暂存的内容暂存起来
多数情况下,应该将所有的内容变为未暂存,然后再选择想要的内容进行 commit。但假定需要这么做,可以创建一个临时的 commit 来保存已暂存的内容,然后暂存那些未暂存的内容并进行 stash。然后 reset 最后一个 commit 将原本暂存的内容变为未暂存,最后 stash pop 回来。
1 | $ git commit -m "WIP" |
Notes:
- 这里使用
pop
仅仅是因为想尽可能保持幂等。- 假如不加上
--index
,会把暂存的文件标记为存储。
3. 未暂存(Unstaged)的内容
3.1. 把未暂存的内容移动到一个新分支
1 | $ git checkout -b my-branch |
3.2. 把未暂存的内容移动到另一个已存在的分支
1 | $ git stash |
3.3. 丢弃本地未提交的变化(uncommitted changes)
如果只是想重置源(origin)和本地(local)之间的一些提交(commit),使用以下命令:
1 | # one commit |
重置某个特殊的文件,可以用文件名做为参数:
1 | $ git reset filename |
3.4. 丢弃某些未暂存的内容
如果想丢弃工作拷贝中的一部分内容,而不是全部。签出(checkout)不需要的内容,保留需要的。
1 | $ git checkout -p |
另外一个方法是使用 stash
,Stash 所有要保留下的内容,重置工作拷贝,重新应用保留的部分。
1 | $ git stash -p |
或者 stash 不需要的部分,然后 stash drop。
1 | $ git stash -p |
4. 分支(Branches)
4.1. 从错误的分支拉取了内容,或把内容拉取到了错误的分支
这是另外一种使用 git reflog
情况,找到在这次错误拉(pull) 之前 HEAD 的指向。
1 | (main)$ git reflog |
重置分支到所需的提交(desired commit):
1 | $ git reset --hard c5bc55a |
4.2. 扔掉本地的提交(commit),让本地分支与远程的保持一致
先确认没有推送(push)本地的内容到远程。使用git status
命令显示领先(ahead)源(origin)多少个提交:
1 | (my-branch)$ git status |
另一种方法:
1 | (main)$ git reset --hard origin/my-branch |
4.3. 提交到一个新分支,但错误的提交到了 main/master
在 main 下创建一个新分支,不切换到新分支,仍在 main 下:
1 | (main)$ git branch my-branch |
把 main 分支重置到前一个提交:
1 | (main)$ git reset --hard HEAD^ |
Tips:
HEAD^
是HEAD^1
的简写,可以通过指定要设置的HEAD
来进一步重置。
或者,如果不想使用 HEAD^
,找到想重置到的提交(commit) 的 hash(git log
能够完成),然后重置到这个 hash。使用git push
同步内容到远程。
例如,main 分支想重置到的提交的 hash 为a13b85e
:
1 | (main)$ git reset --hard a13b85e |
签出(checkout)刚才新建的分支继续工作:
1 | (main)$ git checkout my-branch |
4.4. 保留来自另外一个 ref-ish 的整个文件
假设正在做一个原型方案(原文为 working spike (see note)),有成百的内容,每个都工作得很好。现在,提交到了一个分支,保存工作内容:
1 | (solution)$ git add -A && git commit -m "Adding all changes from this spike into one big commit." |
当想要把它放到一个分支里 (可能是feature
或者 develop
),关心是保持整个文件的完整,想要一个大的提交分隔成比较小。假设:
- 分支
solution
,拥有原型方案,领先develop
分支 - 分支
develop
,在这里应用原型方案的一些内容
可以通过把内容拿到 develop
分支里,来解决这个问题:
1 | (develop)$ git checkout solution -- file1.txt |
这会把这个文件内容从分支 solution
拿到分支 develop
里来:
1 | # On branch develop |
然后正常提交
4.5. 把几个提交(commit)提交到了同一个分支,而这些提交应该分布在不同的分支里
假设有一个main
分支,执行git log
,看到做过两次提交:
1 | (main)$ git log |
先用提交 hash(commit hash)标记 bug (e3851e8
for #21, 5ea5173
for #14).
首先把main
分支重置到正确的提交(a13b85e
):
1 | (main)$ git reset --hard a13b85e |
对 bug #21
创建一个新的分支:
1 | (main)$ git checkout -b 21 |
接着,用_cherry-pick_
把对bug #21
的提交放入当前分支。这意味着将应用(apply)这个提交(commit),仅仅这一个提交(commit),直接在 HEAD 上面。
1 | (21)$ git cherry-pick e3851e8 |
此时这里可能会产生冲突,参见交互式 rebasing 章 冲突节 解决冲突。然后为 bug #14
创建一个新的分支, 也基于main
分支
1 | (21)$ git checkout main |
最后为 bug #14
执行 cherry-pick
:
1 | (14)$ git cherry-pick 5ea5173 |
4.6. 删除上游(upstream)分支被删除了的本地分支
一旦在 github 上面合并(merge)了一个pull request
,就可以删除 fork 里被合并的分支。如果不准备继续在这个分支里工作,删除这个分支的本地拷贝会更干净,使不会陷入工作分支和一堆陈旧分支的混乱之中。
1 | $ git fetch -p |
4.7. 不小心删除了分支
如果定期推送到远程,多数情况下应该是安全的,但有些时候还是可能删除了还没有推到远程的分支。下面模拟这种场景,先创建一个分支和一个新的文件
1 | (main)$ git checkout -b my-branch |
添加文件并做一次提交
1 | (my-branch)$ git add . |
现在切回到主(main)分支,删除my-branch
分支
1 | (my-branch)$ git checkout main |
而reflog
是一个升级版的日志,它存储了仓库(repo)里面所有动作的历史。
1 | (main)$ git reflog |
有一个来自删除分支的提交 hash(commit hash),接下来恢复删除了的分支。
1 | (main)$ git checkout -b my-branch-help |
Git 的 reflog
在 rebasing 出错的时候也是同样有用的。
4.8. 删除一个分支
删除一个远程分支:
1 | (main)$ git push origin --delete my-branch |
删除一个本地分支
1 | (main)$ git branch -D my-branch |
4.9. 从别人正在工作的远程分支签出(checkout)一个分支
从远程拉取(fetch) 所有分支:
1 | (main)$ git fetch --all |
假设想要从远程的daves
分支签出到本地的daves
1 | (main)$ git checkout --track origin/daves |
(--track
是 git checkout -b [branch] [remotename]/[branch]
的简写)。这样就得到了一个daves
分支的本地拷贝, 任何推过(pushed)的更新,远程都能看到.
5. Rebasing 和合并(Merging)
5.1. 撤销 rebase/merge
可以合并(merge)或 rebase 了一个错误的分支, 或者完成不了一个进行中的 rebase/merge。Git 在进行危险操作的时候会把原始的 HEAD 保存在一个叫`ORIG_HEAD
的变量里, 所以要把分支恢复到 rebase/merge 前的状态是很容易的。
1 | (my-branch)$ git reset --hard ORIG_HEAD |
5.2. 已经 rebase 过, 但是我不想强推(force push)
如果想把这些变化(changes)反应到远程分支上,就必须得强推(force push
)。是因快进(Fast forward
)了提交,改变了 Git 历史, 远程分支不会接受变化(changes),除非强推(force push)。
这就是许多人使用 merge 工作流,而不是 rebasing 工作流的主要原因之一,开发者的强推(force push)会使大的团队陷入麻烦。使用时需要注意,一种安全使用 rebase 的方法是,不要把你的变化(changes)反映到远程分支上,而是按下面的做:
1 | (main)$ git checkout my-branch |
5.3. 组合(combine)几个提交(commit)
假设工作分支将会做对于 main
的 pull-request。一般情况下不关心提交(commit)的时间戳,只想组合所有提交(commit) 到一个单独的里面, 然后重置(reset)重提交(recommit)。确保主(main)分支是最新的和本地变化都已经提交了,然后
1 | (my-branch)$ git reset --soft main |
如果想要更多的控制,想要保留时间戳,则需要做交互式 rebase (interactive rebase)
1 | (my-branch)$ git rebase -i main |
如果没有相对的其它分支, 将不得不相对自己的HEAD
进行 rebase。例如:想组合最近的两次提交(commit),将相对于HEAD~2
进行 rebase,组合最近 3 次提交(commit),相对于HEAD~3
, 等等
1 | (main)$ git rebase -i HEAD~2 |
在执行了交互式 rebase 的命令(interactive rebase command)后,将在编辑器里看到类似下面的内容
1 | pick a9c8a1d Some refactoring |
所有以 #
开头的行都是注释,不会影响 rebase。然后可以用任何上面命令列表的命令替换 pick
,也可以通过删除对应的行来删除一个提交(commit)。
例如如果想单独保留最旧(first)的提交(commit),组合所有剩下的到第二个里面,就应该编辑第二个提交(commit)后面的每个提交(commit) 前的单词为 f
:
1 | pick a9c8a1d Some refactoring |
如果想组合这些提交(commit)并重命名这个提交(commit),应该在第二个提交(commit)旁边添加一个r
,或者更简单的用s
替代 f
:
1 | pick a9c8a1d Some refactoring |
可以在接下来弹出的文本提示框里重命名提交(commit)
1 | Newer, awesomer features |
如果成功了,应该看到类似下面的内容:
1 | (main)$ Successfully rebased and updated refs/heads/main. |
5.3.1. 安全合并(merging)策略
--no-commit
执行合并(merge)但不自动提交,给用户在做提交前检查和修改的机会。no-ff
会为特性分支(feature branch)的存在过留下证据,保持项目历史一致。
1 | (main)$ git merge --no-ff --no-commit my-branch |
5.3.2. 将一个分支合并成一个提交(commit)
1 | (main)$ git merge --squash my-branch |
5.3.3. 组合(combine)未推的提交(unpushed commit)
有时候在将数据推向上游之前,有几个正在进行的工作提交(commit)。这时候不希望把已经推(push)过的组合进来,因为其他人可能已经有提交(commit)引用它们了。
1 | (main)$ git rebase -i @{u} |
这会产生一次交互式的 rebase(interactive rebase),只会列出没有推(push)的提交(commit),在这个列表时进行 reorder/fix/squash 都是安全的。
5.4. 检查是否分支上的所有提交(commit)都合并(merge)过了
检查一个分支上的所有提交(commit)是否都已经合并(merge)到了其它分支,应该在这些分支的 head(或任何 commits)之间做一次 diff
1 | (main)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll |
这会说明在一个分支里有而另一个分支没有的所有提交(commit),和分支之间不共享的提交(commit)的列表。另一个做法可以是:
1 | (main)$ git log main ^feature/120-on-scroll --no-merges |
5.5. 交互式 rebase(interactive rebase)可能出现的问题
5.5.1. 这个 rebase 编辑屏幕出现’noop’
如果看到的是这样:
1 | noop |
这意味着 rebase 的分支和当前分支在同一个提交(commit)上,或者领先(ahead)当前分支。可以尝试:
- 检查确保主(main)分支没有问题
- rebase
HEAD~2
或者更早
5.5.2. 有冲突的情况
如果不能成功的完成 rebase,可能必须要解决冲突。首先执行 git status
找出哪些文件有冲突:
1 | (my-branch)$ git status |
在这个例子里面, README.md
有冲突。打开这个文件找到类似下面的内容:
1 | <<<<<<< HEAD |
需要解决新提交的代码(示例里, 从中间==
线到new-commit
的地方)与HEAD
之间不一样的地方。有时候这些合并非常复杂,应该使用可视化的差异编辑器(visual diff editor):
1 | (main*)$ git mergetool -t opendiff |
在解决完所有冲突和测试过后,git add
变化了的(changed)文件,然后用git rebase --continue
继续 rebase。
1 | (my-branch)$ git add README.md |
如果在解决完所有的冲突过后,得到了与提交前一样的结果,可以执行git rebase --skip
。
任何时候想结束整个 rebase 过程,回来 rebase 前的分支状态,,可以做:
1 | (my-branch)$ git rebase --abort |
6. Stash
6.1. 暂存所有改动
暂存工作目录下的所有改动:
1 | $ git stash |
也可以使用-u
来排除一些文件
1 | $ git stash -u |
6.2. 暂存指定文件
只暂存某一个文件
1 | $ git stash push working-directory-path/filename.ext |
暂存多个文件
1 | $ git stash push working-directory-path/filename1.ext working-directory-path/filename2.ext |
6.3. 暂存时记录消息
可以在list
时看到它
1 | $ git stash save <message> |
6.4. 指定暂存
首先可以查看 stash
记录
1 | $ git stash list |
然后可以apply
某个stash
1 | $ git stash apply "stash@{n}" |
这里的 n
是 stash
在栈中的位置,最上层的stash
会是 0。除此之外,也可以使用时间标记(假如你能记得的话)。
1 | $ git stash apply "stash@{2.hours.ago}" |
6.5. 暂存时保留未暂存的内容
需要手动 create 一个stash commit
,然后使用git stash store
。
1 | $ git stash create |
7. 杂项(Miscellaneous Objects)
7.1. 克隆所有子模块
1 | $ git clone --recursive git://github.com/foo/bar.git |
如果已经克隆了:
1 | $ git submodule update --init --recursive |
7.2. 删除标签(tag)
1 | $ git tag -d <tag_name> |
7.3. 恢复已删除标签(tag)
如果想恢复一个已删除标签(tag),可以按照下面的步骤:
- 需要找到无法访问的标签(unreachable tag):
1 | $ git fsck --unreachable | grep tag |
- 记下这个标签(tag)的 hash,然后用 Git 的
update-ref
1 | $ git update-ref refs/tags/<tag_name> <hash> |
7.4. 已删除补丁(patch)
如果某人在 GitHub 上发了一个pull request
,但是然后他删除了他自己的原始 fork,这样将没法克隆他们的提交(commit)或使用 git am
。在这种情况下,最好手动的查看他们的提交(commit),并把它们拷贝到一个本地新分支,然后做提交。
做完提交后,再修改作者(参见“变更作者”章节)。然后应用变化,再发起一个新的pull request
。
8. 跟踪文件(Tracking Files)
8.1. 改变一个文件名字的大小写,而不修改内容
1 | (main)$ git mv --force myfile MyFile |
8.2. 从 Git 删除一个文件,但保留该文件
1 | (main)$ git rm --cached log.txt |
9. 配置(Configuration)
9.1. 给一些 Git 命令添加别名(alias)
在 OS X 和 Linux 下,Git 的配置文件储存在 ~/.gitconfig
。在[alias]
部分添加了一些快捷别名(和一些容易拼写错误的),如下:
1 | [alias] |
9.2. 缓存一个仓库(repository)的用户名和密码
有一个仓库需要授权,此时可以缓存用户名和密码,而不用每次推/拉(push/pull)的时候都输入,可以使用 Credential helper 来实现。
1 | $ git config --global credential.helper cache |
9.3. reflog
如果 重置(reset)
了一些东西,或者合并了错误的分支,又或强推了后找不到自己的提交(commit)了,想回到以前的某个状态。
这就是 git reflog
的目的,reflog
记录对分支顶端(the tip of a branch)的任何改变,即使那个顶端没有被任何分支或标签引用。基本上,每次 HEAD 的改变,一条新的记录就会增加到reflog
。遗憾的是,这只对本地分支起作用,且它只跟踪动作 (例如,不会跟踪一个没有被记录的文件的任何改变)。
1 | (main)$ git reflog |
上面的 reflog 展示了从 main 分支签出(checkout)到 2.2 分支,然后再签回。还有一个硬重置(hard reset)到一个较旧的提交。最新的动作出现在最上面以 HEAD@{0}
标识.
如果事实证明不小心回移(move back)了提交(commit),reflog 会包含不小心回移前 main 上指向的提交(0254ea7)。
1 | $ git reset --hard 0254ea7 |
然后使用git reset
就可以把 main 改回到之前的 commit,这提供了一个在历史被意外更改情况下的安全网。