Git Cherrypick使用

2023年 8月 13日 27.7k 0

概述

无论项目大小,当你和一群程序员一起工作时,处理多个 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 命令?

流程概述

下面是使用步骤:

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

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

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

    git log --oneline
    

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

    语法如下:

    git cherry-pick 
    

    📝Notes:

    可以是多个

    例如:

    git cherry-pick  85c5532
    

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

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

    语法如下:

    git cherry-pick  --no-commit
    

    如:

    git cherry-pick 85c5532 --no-commit
    

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

    git cherry-pick hash1 hash3
    

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

    Cherry-pick 实战

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

    mkdir fruit.git
    cd fruit.git
    git init .
    

    创建一些数据并提交:

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

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

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

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

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

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

    $ 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...
    
    $ git log –oneline dev/master
    e858ab2 Added a vegetable that tastes like a fruit 
    0664292 Added a fruit 
    b56e0f8 First commit
    

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

    git cherry-pick 0664292
    

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

    $ cat fruit.txt
    Kiwifruit
    Strawberry
    

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

    Cherry-pick 多个提交实战

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

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

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

    继续 cherry-pick:

    git cherry-pick --continue
    

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

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

    继续 cherry-pick:

    git cherry-pick --continue
    

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

    此时, 可以提交:

    git push origin main
    

    总结

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

    📚️参考文档

    • What is Git cherry-picking? | Opensource.com
    • How to merge only specific commits from a pull request with git cherry-pick | MattStauffer.com
    • Git Cherry Pick - How to use the "cherry-pick" command in Git | Learn Version Control with Git

    三人行, 必有我师; 知识共享, 天下为公. 本文由东风微鸣技术博客 EWhisper.cn 编写.

    相关文章

    JavaScript2024新功能:Object.groupBy、正则表达式v标志
    PHP trim 函数对多字节字符的使用和限制
    新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
    使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
    为React 19做准备:WordPress 6.6用户指南
    如何删除WordPress中的所有评论

    发布评论