Git 规则
Git 飞行规则(Flight Rules)
- 编辑提交(editting commits)
- 暂存(Staging)
- 未暂存(Unstaged)的内容
- 分支(Branches)
- Rebasing 和合并(Merging)
- Stash
- 杂项(Miscellaneous Objects)
- 跟踪文件(Tracking Files)
- 配置(Configuration)
- 我不知道我做错了些什么
- 其它资源(Other Resources)
编辑提交(editting commits)
我刚才提交了什么?
如果你用 git commit -a
提交了一次变化(changes),而你又不确定到底这次提交了哪些内容。 你就可以用下面的命令显示当前HEAD
上的最近一次的提交(commit):
|
|
或者
|
|
我的提交信息(commit message)写错了
如果你的提交信息(commit message)写错了且这次提交(commit)还没有推(push), 你可以通过下面的方法来修改提交信息(commit message):
|
|
这会打开你的默认编辑器, 在这里你可以编辑信息. 另一方面, 你也可以用一条命令一次完成:
|
|
如果你已经推(push)了这次提交(commit), 你可以修改这次提交(commit)然后强推(force push), 但是不推荐这么做。
我提交(commit)里的用户名和邮箱不对
如果这只是单个提交(commit),修改它:
|
|
如果你需要修改所有历史, 参考 ‘git filter-branch’的指南页.
我想从一个提交(commit)里移除一个文件
通过下面的方法,从一个提交(commit)里移除一个文件:
|
|
这将非常有用,当你有一个开放的补丁(open patch),你往上面提交了一个不必要的文件,你需要强推(force push)去更新这个远程补丁。
我想删除我的的最后一次提交(commit)
如果你需要删除推了的提交(pushed commits),你可以使用下面的方法。可是,这会不可逆的改变你的历史,也会搞乱那些已经从该仓库拉取(pulled)了的人的历史。简而言之,如果你不是很确定,千万不要这么做。
|
|
如果你还没有推到远程, 把 Git 重置(reset)到你最后一次提交前的状态就可以了(同时保存暂存的变化):
|
|
这只能在没有推送之前有用. 如果你已经推了, 唯一安全能做的是 git revert SHAofBadCommit
, 那会创建一个新的提交(commit)用于撤消前一个提交的所有变化(changes); 或者, 如果你推的这个分支是 rebase-safe 的 (例如: 其它开发者不会从这个分支拉), 只需要使用 git push -f
; 更多, 请参考 the above section。
删除任意提交(commit)
同样的警告:不到万不得已的时候不要这么做.
|
|
或者做一个 交互式 rebase 删除那些你想要删除的提交(commit)里所对应的行。
我尝试推一个修正后的提交(amended commit)到远程,但是报错:
|
|
注意, rebasing(见下面)和修正(amending)会用一个新的提交(commit)代替旧的, 所以如果之前你已经往远程仓库上推过一次修正前的提交(commit),那你现在就必须强推(force push) (-f
)。 注意 – 总是 确保你指明一个分支!
|
|
一般来说, 要避免强推. 最好是创建和推(push)一个新的提交(commit),而不是强推一个修正后的提交。后者会使那些与该分支或该分支的子分支工作的开发者,在源历史中产生冲突。
我意外的做了一次硬重置(hard reset),我想找回我的内容
如果你意外的做了 git reset --hard
, 你通常能找回你的提交(commit), 因为 Git 对每件事都会有日志,且都会保存几天。
|
|
你将会看到一个你过去提交(commit)的列表, 和一个重置的提交。 选择你想要回到的提交(commit)的 SHA,再重置一次:
|
|
这样就完成了。
暂存(Staging)
我需要把暂存的内容添加到上一次的提交(commit)
|
|
我想要暂存一个新文件的一部分,而不是这个文件的全部
一般来说, 如果你想暂存一个文件的一部分, 你可这样做:
|
|
-p
简写。这会打开交互模式, 你将能够用 s
选项来分隔提交(commit); 然而, 如果这个文件是新的, 会没有这个选择, 添加一个新文件时, 这样做:
|
|
然后, 你需要用 e
选项来手动选择需要添加的行,执行 git diff --cached
将会显示哪些行暂存了哪些行只是保存在本地了。
我想把在一个文件里的变化(changes)加到两个提交(commit)里
git add
会把整个文件加入到一个提交. git add -p
允许交互式的选择你想要提交的部分.
我想把暂存的内容变成未暂存,把未暂存的内容暂存起来
多数情况下,你应该将所有的内容变为未暂存,然后再选择你想要的内容进行 commit。 但假定你就是想要这么做,这里你可以创建一个临时的 commit 来保存你已暂存的内容,然后暂存你的未暂存的内容并进行 stash。然后 reset 最后一个 commit 将原本暂存的内容变为未暂存,最后 stash pop 回来。
|
|
注意 1: 这里使用pop
仅仅是因为想尽可能保持幂等。
注意 2: 假如你不加上--index
你会把暂存的文件标记为为存储.这个链接 解释得比较清楚。(不过是英文的,其大意是说,这是一个较为底层的问题,stash 时会做 2 个 commit,其中一个会记录 index 状态,staged 的文件等东西,另一个记录 worktree 和其他的一些东西,如果你不在 apply 时加 index,git 会把两个一起销毁,所以 staged 里就空了)。
未暂存(Unstaged)的内容
我想把未暂存的内容移动到一个新分支
|
|
我想把未暂存的内容移动到另一个已存在的分支
|
|
我想丢弃本地未提交的变化(uncommitted changes)
如果你只是想重置源(origin)和你本地(local)之间的一些提交(commit),你可以:
|
|
重置某个特殊的文件, 你可以用文件名做为参数:
|
|
我想丢弃某些未暂存的内容
如果你想丢弃工作拷贝中的一部分内容,而不是全部。
签出(checkout)不需要的内容,保留需要的。
|
|
另外一个方法是使用 stash
, Stash 所有要保留下的内容, 重置工作拷贝, 重新应用保留的部分。
|
|
或者, stash 你不需要的部分, 然后 stash drop。
|
|
分支(Branches)
我从错误的分支拉取了内容,或把内容拉取到了错误的分支
这是另外一种使用 git reflog
情况,找到在这次错误拉(pull) 之前 HEAD 的指向。
|
|
重置分支到你所需的提交(desired commit):
|
|
完成。
我想扔掉本地的提交(commit),以便我的分支与远程的保持一致
先确认你没有推(push)你的内容到远程。
git status
会显示你领先(ahead)源(origin)多少个提交:
|
|
一种方法是:
|
|
我需要提交到一个新分支,但错误的提交到了 main
在 main 下创建一个新分支,不切换到新分支,仍在 main 下:
|
|
把 main 分支重置到前一个提交:
|
|
HEAD^
是 HEAD^1
的简写,你可以通过指定要设置的HEAD
来进一步重置。
或者, 如果你不想使用 HEAD^
, 找到你想重置到的提交(commit)的 hash(git log
能够完成), 然后重置到这个 hash。 使用git push
同步内容到远程。
例如, main 分支想重置到的提交的 hash 为a13b85e
:
|
|
签出(checkout)刚才新建的分支继续工作:
|
|
我想保留来自另外一个 ref-ish 的整个文件
假设你正在做一个原型方案(原文为 working spike (see note)), 有成百的内容,每个都工作得很好。现在, 你提交到了一个分支,保存工作内容:
|
|
当你想要把它放到一个分支里 (可能是feature
, 或者 develop
), 你关心是保持整个文件的完整,你想要一个大的提交分隔成比较小。
假设你有:
- 分支
solution
, 拥有原型方案, 领先develop
分支。 - 分支
develop
, 在这里你应用原型方案的一些内容。
我去可以通过把内容拿到你的分支里,来解决这个问题:
|
|
这会把这个文件内容从分支 solution
拿到分支 develop
里来:
|
|
然后, 正常提交。
Note: Spike solutions are made to analyze or solve the problem. These solutions are used for estimation and discarded once everyone gets clear visualization of the problem. ~ Wikipedia.
我把几个提交(commit)提交到了同一个分支,而这些提交应该分布在不同的分支里
假设你有一个main
分支, 执行git log
, 你看到你做过两次提交:
|
|
让我们用提交 hash(commit hash)标记 bug (e3851e8
for #21, 5ea5173
for #14).
首先, 我们把main
分支重置到正确的提交(a13b85e
):
|
|
现在, 我们对 bug #21 创建一个新的分支:
|
|
接着, 我们用 cherry-pick 把对 bug #21 的提交放入当前分支。 这意味着我们将应用(apply)这个提交(commit),仅仅这一个提交(commit),直接在 HEAD 上面。
|
|
这时候, 这里可能会产生冲突, 参见交互式 rebasing 章 冲突节 解决冲突.
再者, 我们为 bug #14 创建一个新的分支, 也基于main
分支
|
|
最后, 为 bug #14 执行 cherry-pick
:
|
|
我想删除上游(upstream)分支被删除了的本地分支
一旦你在 github 上面合并(merge)了一个 pull request, 你就可以删除你 fork 里被合并的分支。 如果你不准备继续在这个分支里工作, 删除这个分支的本地拷贝会更干净,使你不会陷入工作分支和一堆陈旧分支的混乱之中。
|
|
我不小心删除了我的分支
如果你定期推送到远程, 多数情况下应该是安全的,但有些时候还是可能删除了还没有推到远程的分支。 让我们先创建一个分支和一个新的文件:
|
|
添加文件并做一次提交
|
|
现在我们切回到主(main)分支,‘不小心的’删除my-branch
分支
|
|
在这时候你应该想起了reflog
, 一个升级版的日志,它存储了仓库(repo)里面所有动作的历史。
|
|
正如你所见,我们有一个来自删除分支的提交 hash(commit hash),接下来看看是否能恢复删除了的分支。
|
|
看! 我们把删除的文件找回来了。 Git 的 reflog
在 rebasing 出错的时候也是同样有用的。
我想删除一个分支
删除一个远程分支:
|
|
你也可以:
|
|
删除一个本地分支:
|
|
我想从别人正在工作的远程分支签出(checkout)一个分支
首先, 从远程拉取(fetch) 所有分支:
|
|
假设你想要从远程的daves
分支签出到本地的daves
|
|
(--track
是 git checkout -b branch] [remotename/branch
的简写)
这样就得到了一个daves
分支的本地拷贝, 任何推过(pushed)的更新,远程都能看到.
Rebasing 和合并(Merging)
我想撤销 rebase/merge
你可以合并(merge)或 rebase 了一个错误的分支, 或者完成不了一个进行中的 rebase/merge。 Git 在进行危险操作的时候会把原始的 HEAD 保存在一个叫 ORIG_HEAD 的变量里, 所以要把分支恢复到 rebase/merge 前的状态是很容易的。
|
|
我已经 rebase 过, 但是我不想强推(force push)
不幸的是,如果你想把这些变化(changes)反应到远程分支上,你就必须得强推(force push)。 是因你快进(Fast forward)了提交,改变了 Git 历史, 远程分支不会接受变化(changes),除非强推(force push)。这就是许多人使用 merge 工作流, 而不是 rebasing 工作流的主要原因之一, 开发者的强推(force push)会使大的团队陷入麻烦。使用时需要注意,一种安全使用 rebase 的方法是,不要把你的变化(changes)反映到远程分支上, 而是按下面的做:
|
|
更多, 参见 this SO thread.
我需要组合(combine)几个提交(commit)
假设你的工作分支将会做对于 main
的 pull-request。 一般情况下你不关心提交(commit)的时间戳,只想组合 所有 提交(commit) 到一个单独的里面, 然后重置(reset)重提交(recommit)。 确保主(main)分支是最新的和你的变化都已经提交了, 然后:
|
|
如果你想要更多的控制, 想要保留时间戳, 你需要做交互式 rebase (interactive rebase):
|
|
如果没有相对的其它分支, 你将不得不相对自己的HEAD
进行 rebase。 例如:你想组合最近的两次提交(commit), 你将相对于HEAD~2
进行 rebase, 组合最近 3 次提交(commit), 相对于HEAD~3
, 等等。
|
|
在你执行了交互式 rebase 的命令(interactive rebase command)后, 你将在你的编辑器里看到类似下面的内容:
|
|
所有以 #
开头的行都是注释, 不会影响 rebase.
然后,你可以用任何上面命令列表的命令替换 pick
, 你也可以通过删除对应的行来删除一个提交(commit)。
例如, 如果你想 单独保留最旧(first)的提交(commit),组合所有剩下的到第二个里面, 你就应该编辑第二个提交(commit)后面的每个提交(commit) 前的单词为 f
:
|
|
如果你想组合这些提交(commit) 并重命名这个提交(commit), 你应该在第二个提交(commit)旁边添加一个r
,或者更简单的用s
替代 f
:
|
|
你可以在接下来弹出的文本提示框里重命名提交(commit)。
|
|
如果成功了, 你应该看到类似下面的内容:
|
|
安全合并(merging)策略
--no-commit
执行合并(merge)但不自动提交, 给用户在做提交前检查和修改的机会。 no-ff
会为特性分支(feature branch)的存在过留下证据, 保持项目历史一致。
|
|
我需要将一个分支合并成一个提交(commit)
|
|
我只想组合(combine)未推的提交(unpushed commit)
有时候,在将数据推向上游之前,你有几个正在进行的工作提交(commit)。这时候不希望把已经推(push)过的组合进来,因为其他人可能已经有提交(commit)引用它们了。
|
|
这会产生一次交互式的 rebase(interactive rebase), 只会列出没有推(push)的提交(commit), 在这个列表时进行 reorder/fix/squash 都是安全的。
检查是否分支上的所有提交(commit)都合并(merge)过了
检查一个分支上的所有提交(commit)是否都已经合并(merge)到了其它分支, 你应该在这些分支的 head(或任何 commits)之间做一次 diff:
|
|
这会告诉你在一个分支里有而另一个分支没有的所有提交(commit), 和分支之间不共享的提交(commit)的列表。 另一个做法可以是:
|
|
交互式 rebase(interactive rebase)可能出现的问题
这个 rebase 编辑屏幕出现’noop’
如果你看到的是这样:
|
|
这意味着你 rebase 的分支和当前分支在同一个提交(commit)上, 或者 领先(ahead) 当前分支。 你可以尝试:
- 检查确保主(main)分支没有问题
- rebase
HEAD~2
或者更早
有冲突的情况
如果你不能成功的完成 rebase, 你可能必须要解决冲突。
首先执行 git status
找出哪些文件有冲突:
|
|
在这个例子里面, README.md
有冲突。 打开这个文件找到类似下面的内容:
|
|
你需要解决新提交的代码(示例里, 从中间==
线到new-commit
的地方)与HEAD
之间不一样的地方.
有时候这些合并非常复杂,你应该使用可视化的差异编辑器(visual diff editor):
|
|
在你解决完所有冲突和测试过后, git add
变化了的(changed)文件, 然后用git rebase --continue
继续 rebase。
|
|
如果在解决完所有的冲突过后,得到了与提交前一样的结果, 可以执行git rebase --skip
。
任何时候你想结束整个 rebase 过程,回来 rebase 前的分支状态, 你可以做:
|
|
Stash
暂存所有改动
暂存你工作目录下的所有改动
|
|
你可以使用-u
来排除一些文件
|
|
暂存指定文件
假设你只想暂存某一个文件
|
|
假设你想暂存多个文件
|
|
暂存时记录消息
这样你可以在list
时看到它
|
|
或
|
|
使用某个指定暂存
首先你可以查看你的stash
记录
|
|
然后你可以apply
某个stash
|
|
此处, ’n’是stash
在栈中的位置,最上层的stash
会是 0
除此之外,也可以使用时间标记(假如你能记得的话)。
|
|
暂存时保留未暂存的内容
你需要手动 create 一个stash commit
, 然后使用git stash store
。
|
|
杂项(Miscellaneous Objects)
克隆所有子模块
|
|
如果已经克隆了:
|
|
删除标签(tag)
|
|
恢复已删除标签(tag)
如果你想恢复一个已删除标签(tag), 可以按照下面的步骤: 首先, 需要找到无法访问的标签(unreachable tag):
|
|
记下这个标签(tag)的 hash,然后用 Git 的 update-ref:
|
|
这时你的标签(tag)应该已经恢复了。
已删除补丁(patch)
如果某人在 GitHub 上给你发了一个 pull request, 但是然后他删除了他自己的原始 fork, 你将没法克隆他们的提交(commit)或使用 git am
。在这种情况下, 最好手动的查看他们的提交(commit),并把它们拷贝到一个本地新分支,然后做提交。
做完提交后, 再修改作者,参见变更作者。 然后, 应用变化, 再发起一个新的 pull request。
跟踪文件(Tracking Files)
我只想改变一个文件名字的大小写,而不修改内容
|
|
我想从 Git 删除一个文件,但保留该文件
|
|
配置(Configuration)
我想给一些 Git 命令添加别名(alias)
在 OS X 和 Linux 下, 你的 Git 的配置文件储存在 ~/.gitconfig
。我在[alias]
部分添加了一些快捷别名(和一些我容易拼写错误的),如下:
|
|
我想缓存一个仓库(repository)的用户名和密码
你可能有一个仓库需要授权,这时你可以缓存用户名和密码,而不用每次推/拉(push/pull)的时候都输入,Credential helper 能帮你。
|
|
|
|
我不知道我做错了些什么
你把事情搞砸了:你 重置(reset)
了一些东西, 或者你合并了错误的分支, 亦或你强推了后找不到你自己的提交(commit)了。有些时候, 你一直都做得很好, 但你想回到以前的某个状态。
这就是 git reflog
的目的, reflog
记录对分支顶端(the tip of a branch)的任何改变, 即使那个顶端没有被任何分支或标签引用。基本上, 每次 HEAD 的改变, 一条新的记录就会增加到reflog
。遗憾的是,这只对本地分支起作用,且它只跟踪动作 (例如,不会跟踪一个没有被记录的文件的任何改变)。
|
|
上面的 reflog 展示了从 main 分支签出(checkout)到 2.2 分支,然后再签回。 那里,还有一个硬重置(hard reset)到一个较旧的提交。最新的动作出现在最上面以 HEAD@{0}
标识.
如果事实证明你不小心回移(move back)了提交(commit), reflog 会包含你不小心回移前 main 上指向的提交(0254ea7)。
|
|
然后使用 git reset 就可以把 main 改回到之前的 commit,这提供了一个在历史被意外更改情况下的安全网。
(摘自).
其它资源(Other Resources)
书(Books)
- Pro Git - Scott Chacon’s excellent git book
- Git Internals - Scott Chacon’s other excellent git book
教程(Tutorials)
- Learn Git branching 一个基于网页的交互式 branching/merging/rebasing 教程
- Getting solid at Git rebase vs. merge
- git-workflow - Aaron Meurer的怎么使用 Git 为开源仓库贡献
- GitHub as a workflow - 使用 GitHub 做为工作流的趣事, 尤其是空 PRs
脚本和工具(Scripts and Tools)
- firstaidgit.io 一个可搜索的最常被问到的 Git 的问题
- git-extra-commands - 一堆有用的额外的 Git 脚本
- git-extras - GIT 工具集 – repo summary, repl, changelog population, author commit percentages and more
- git-fire - git-fire 是一个 Git 插件,用于帮助在紧急情况下添加所有当前文件, 做提交(committing), 和推(push)到一个新分支(阻止合并冲突)。
- git-tips - Git 小提示
- git-town - 通用,高级 Git 工作流支持! http://www.git-town.com