git cherry-pick 用于从其他分支中选择一个或多个特定的提交(commit)并将它们应用到当前分支上。
在我们进行多分支开发时,将代码从一个分支转移到其他分支是非常常见的。
若需要将一个分支中的所有代码合并,使用 git merge。
若需要将一个分支中的部分提交 commit 变动,使用 git cherry-pick。此时引入特定更改或功能到当前分支时非常有用。
1、选择单个提交
1 |
git cherry-pick <commit-hash> |
2、选择一系列提交
闭区间 [ 1,3 ]
1 |
git cherry-pick <commit-hash1>^..<commit-hash3> |
开区间 ( 1,3 ]
1 |
git cherry-pick <commit-hash1>..<commit-hash3> |
3、选择多个非连续提交
1 |
git cherry-pick <commit-hash1> <commit-hash3> <commit-hash5> |
注意??:选择多个提交时,必须按照正确的顺序进行,提交 1 必须早于提交 2,否则命令将失败,但不会报错。
假如我们在 'feature' 分支上有以下提交历史:
1 |
(feature):A - B - C - D - E |
现在在 'main' 分支上:
1 |
(main):F - G |
此时我们需要将 ' feature' 分支上的 C 和 D 提交应用到 'main' 分支上,使用:
1 2 |
git checkout main git cherry-pick C D |
这样,'main' 分支的提交历史变成:
1 |
(main):F - G - C' - D' |
其中 C' 和 D' 是应用于 'main' 分支的 C 和 D 提交,提交内容是一样的,但是分支 hash 值是不同的。
git cherry-pick 命令的参数不一定是提交的 hash 值,分支名也 ok,表示转移该分支的最新提交。
1 2 3 |
git cherry-pick feature # 等价于 git cherry-pick E |
如果在 cherry-pick 过程中出现冲突时,Git 会暂停操作,让我们手动解决冲突。
1、解决冲突之后,需要继续 cherry-pick 过程:
1 2 |
git add <resolved-files> git cherry-pick --continue |
2、放弃 cherry-pick 操作,回到操作前
1 |
git cherry-pick --abort |
3、放弃 cherry-pick 操作,但是不回到操作前(不推荐)
1 |
git cherry-pick --quit |