Git Cherry-pick 使用

本文最后更新于:2024年7月24日 晚上

概述

无论项目大小,当你和一群程序员一起工作时,处理多个 Git 分支之间的变更都会变得很困难。有时,与其把整个 Git 分支合并到另一个分支,不如选择并移动几个特定的提交。这个过程被称为 “挑拣”, 即 Cherry-pick。

本文将介绍 “Cherry-pick” 的内容、原因和方法。

让我们开始吧~

什么是 Cherry-pick?

通过 cherry-pick 命令,Git 可以将任何分支中的选定提交合并到 当前的 Git HEAD 分支 中。

在执行 git mergegit rebase 时,一个分支的所有提交都会被合并。而 cherry-pick 命令则允许你选择单个提交进行整合。

区别图示如下:

使用 merge 或 rebase 的情况
△ 使用 merge 的情况: 在执行 merge 或 rebase 时,一个分支的所有提交都会被整合。

使用 cherry-pick 的情况
△ 使用 cherry-pick 的情况: 允许你选择 个别 提交进行整合。在本例中,只有 C2 被整合到主分支,而不是 C4。

为什么要用 Cherry-pick?

下面的情况可能更容易理解 “Cherry-pick” 的作用。

想象一下,您正在为即将到来的每周 spring 实施新功能。代码准备就绪后,您将把它推送到远程分支,准备进行测试。

然而,客户并不满意所有的修改,要求你只提交某些修改。因为客户还没有批准下次发布的所有修改,所以 git rebase 不会产生预期的结果。因为 git rebasegit merge 会将上一次冲刺的所有调整都纳入其中。

而 “Cherry-pick” 就能解决这个问题!因为 “Cherry-pick” 只关注提交中添加的改动,所以它只会带来已批准的改动,而不会添加其他提交。

使用 “Cherry-pick” 还有其他一些原因:

  • 这对修复 bug 非常重要,因为开发分支中的 bug 都是用它们的提交设置的。
  • 通过使用 git cherry-pick,而不是其他应用指定提交的改动的选项(如 git diff),可以避免不必要的争斗。
  • 如果因为各 Git 分支的版本不兼容而无法进行完整的分支合并,它就是一个很有用的工具。

什么时候用 Cherry-pick?

简而言之就是:尽量少用。之所以要尽量少用 cherry-pick,是因为它很容易产生 " 重复 " 提交:当你使用 cherry-pick 将一个提交整合到 HEAD 分支时,Git 必须创建一个内容完全相同的新提交。不过,这是一个全新的提交对象,有自己的 SHA 标识符。同时也会失去跟踪提交历史的能力。

如果你不按顺序提交了很多提交,这些提交就会被记录在你的分支中,这可能会导致你的 Git 分支出现不理想的结果。

只要能用传统的合并或重置来整合,就应该这么做。Cherry-pick 应保留给不可能这样做的情况,例如必须创建 Hotfix 或只想从一个废弃的分支中保存一个或几个提交。

如何使用 Cherry-pick 命令?

流程概述

下面是使用步骤:

  1. 拉取本地分支。使用 git fetch
  2. 回到要合并的分支。你可能会通过运行 git checkout main 来做到这一点。
  3. 找到要拉入分支的提交。转到 git log,为每条提交获取唯一的提交哈希值。
  4. “Cherry-pick” 您想要加入该分支的提交。运行以下命令:git cherry-pick <commit sha>。这将只把这个提交拉入当前分支。
  5. (可选) 在某些情况下, 可能需要手动解决冲突.
  6. 像往常一样推送这个分支: git push origin main

具体命令

cherry-pick 命令的最简单形式中,你只需使用要集成到当前 HEAD 分支中的提交的 SHA 标识符即可。

要获取提交哈希值,可以使用 git log 命令:

1
git log --oneline

知道 commit 的哈希值后,就可以使用 cherry-pick 命令。

语法如下:

1
git cherry-pick <commit sha>

📝Notes:

<commit sha> 可以是多个

例如:

1
git cherry-pick  85c5532

这将把指定的更改专用于当前已签出的分支。

如果你想做进一步修改,也可以指示 Git 在你的工作副本中添加提交改动。

语法如下:

1
git cherry-pick <commit sha> --no-commit

如:

1
git cherry-pick 85c5532 --no-commit

如果您想同时选择多个提交,请添加它们的提交哈希值,中间用空格隔开:

1
git cherry-pick hash1 hash3

在挑选提交时,不能使用 git pull 命令,因为它会从一个版本库中获取提交并自动合并到另一个版本库中。cherry-pick 命令是专门用来避免这种情况发生的工具;取而代之的是使用 git fetch,它会获取提交但不应用它们。

Cherry-pick 实战

要尝试该过程,请启动终端并生成一个示例项目:

1
2
3
mkdir fruit.git
cd fruit.git
git init .

创建一些数据并提交:

1
2
3
echo "Kiwifruit" > fruit.txt
git add fruit.txt
git commit -m 'First commit'

现在,创建一个项目的 fork 来代表远程开发者:

1
2
3
4
5
mkdir ~/fruit.fork
cd !$
echo "Strawberry" >> fruit.txt
git add fruit.txt
git commit -m 'Added a fruit"

这是一个有效的提交。现在,创建一个糟糕的提交,代表你不想合并到项目中的内容:

1
2
3
echo "Rhubarb" >> fruit.txt
git add fruit.txt
git commit -m 'Added a vegetable that tastes like a fruit"

返回你的权威版本库,从你假想的开发者那里获取提交(使用 git fetch 获取):

1
2
3
4
5
6
7
$ cd ~/fruit.git
$ git remote add dev ~/fruit.fork
$ git fetch dev
remote: Counting objects: 6, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 6 (delta 0), reused 0 (delta 0)
Unpacking objects: 100% (6/6), done...
1
2
3
4
$ git log –oneline dev/master
e858ab2 Added a vegetable that tastes like a fruit
0664292 Added a fruit
b56e0f8 First commit

你已经从假想的开发者那里获取了提交,但还没有将它们合并到你的版本库中。你想接受第二个提交,但不想接受第三个,所以要使用 cherry-pick

1
git cherry-pick 0664292

现在,第二个提交就在你的版本库中:

1
2
3
$ cat fruit.txt
Kiwifruit
Strawberry

将更改推送到远程服务器,就大功告成了!

Cherry-pick 多个提交实战

从 dev 挑选数个 commits 进行合并:

1
git cherry-pick  85c5532  366a196  53ebe44 --no-commits

然后, 可能第一个合并会出现冲突, 手动解决冲突, 并git add 具体文件或 git rm.

继续 cherry-pick:

1
git cherry-pick --continue

第二个提交可能没有冲突, 直接合并.

第三个提交可能又有冲突, 手动解决冲突, 并git add 具体文件或 git rm.

继续 cherry-pick:

1
git cherry-pick --continue

最后再执行 git cherry-pick --continue, 会提示你没有在运行的任务.

此时, 可以提交:

1
git push origin main

总结

Cherry-pick 是一个功能强大的命令,如果没有正确理解可能发生的情况,使用它可能会带来麻烦。不过,当你搞砸并提交到错误的分支时,它可能会拯救你的生命(至少是你的日常工作)。

📚️参考文档