git cherry-pick的使用教程

一时失言乱红尘 2022-12-30 11:59 93阅读 0赞

对于多分支的代码库，将代码从一个分支转移到另一个分支是常见需求。

这时分两种情况。一种情况是，你需要另一个分支的所有代码变动，那么就采用合并（`git merge`）。另一种情况是，你只需要部分代码变动（某几个提交），这时可以采用 Cherry pick。

![format_png][]

## 一、基本用法 ##

`git cherry-pick`命令的作用，就是将指定的提交（commit）应用于其他分支。

> 1.  `$ git cherry-pick <commitHash>`

上面命令就会将指定的提交`commitHash`，应用于当前分支。这会在当前分支产生一个新的提交，当然它们的哈希值会不一样。

举例来说，代码仓库有`master`和`feature`两个分支。

> 1.  `a - b - c - d Master`
> 2.  `e - f - g Feature`

现在将提交`f`应用到`master`分支。

> 1.  `# 切换到 master 分支`
> 2.  `$ git checkout master`
> 3.  `# Cherry pick 操作`
> 4.  `$ git cherry-pick f`

上面的操作完成以后，代码库就变成了下面的样子。

> 1.  `a - b - c - d - f Master`
> 2.  `e - f - g Feature`

从上面可以看到，`master`分支的末尾增加了一个提交`f`。

`git cherry-pick`命令的参数，不一定是提交的哈希值，分支名也是可以的，表示转移该分支的最新提交。

> 1.  `$ git cherry-pick feature`

上面代码表示将`feature`分支的最近一次提交，转移到当前分支。

## 二、转移多个提交 ##

Cherry pick 支持一次转移多个提交。（亲测试ok）

> 1.  `$ git cherry-pick <HashA> <HashB>`

上面的命令将 A 和 B 两个提交应用到当前分支。这会在当前分支生成两个对应的新提交。

如果想要转移一系列的连续提交，可以使用下面的简便语法。

> 1.  `$ git cherry-pick A..B`

上面的命令可以转移从 A 到 B 的所有提交。它们必须按照正确的顺序放置：提交 A 必须早于提交 B，否则命令将失败，但不会报错。

注意，使用上面的命令，提交 A 将不会包含在 Cherry pick 中。如果要包含提交 A，可以使用下面的语法。

> 1.  `$ git cherry-pick A^..B`

## 三、配置项 ##

`git cherry-pick`命令的常用配置项如下。

**（1）`-e`，`--edit`**

打开外部编辑器，编辑提交信息。

**（2）`-n`，`--no-commit`**

只更新工作区和暂存区，不产生新的提交。

**（3）`-x`**

在提交信息的末尾追加一行`(cherry picked from commit ...)`，方便以后查到这个提交是如何产生的。

**（4）`-s`，`--signoff`**

在提交信息的末尾追加一行操作者的签名，表示是谁进行了这个操作。

**（5）`-m parent-number`，`--mainline parent-number`**

如果原始提交是一个合并节点，来自于两个分支的合并，那么 Cherry pick 默认将失败，因为它不知道应该采用哪个分支的代码变动。

`-m`配置项告诉 Git，应该采用哪个分支的变动。它的参数`parent-number`是一个从`1`开始的整数，代表原始提交的父分支编号。

> 1.  `$ git cherry-pick -m 1 <commitHash>`

上面命令表示，Cherry pick 采用提交`commitHash`来自编号1的父分支的变动。

一般来说，1号父分支是接受变动的分支（the branch being merged into），2号父分支是作为变动来源的分支（the branch being merged from）。

## 四、代码冲突 ##

如果操作过程中发生代码冲突，Cherry pick 会停下来，让用户决定如何继续操作。

**（1）`--continue`**

用户解决代码冲突后，第一步将修改的文件重新加入暂存区（`git add .`），第二步使用下面的命令，让 Cherry pick 过程继续执行。

> 1.  `$ git cherry-pick --continue`

**（2）`--abort`**

1.  `$ git cherry-pick --abort`

发生代码冲突后，放弃合并，回到操作前的样子。

**（3）`--quit`**

发生代码冲突后，退出 Cherry pick，但是不回到操作前的样子。

## 五、转移到另一个代码库 ##

Cherry pick 也支持转移另一个代码库的提交，方法是先将该库加为远程仓库。

> 1.  `$ git remote add target git://gitUrl`

上面命令添加了一个远程仓库`target`。

然后，将远程代码抓取到本地。

> 1.  `$ git fetch target`

上面命令将远程代码仓库抓取到本地。

接着，检查一下要从远程仓库转移的提交，获取它的哈希值。

> 1.  `$ git log target/master`

最后，使用`git cherry-pick`命令转移提交。

> 1.  `$ git cherry-pick <commitHash>`

[format_png]: /images/20221120/824f7a9ad71541839b6b7b709a80d801.png

发表评论取消回复

表情：

评论列表（有 0 条评论，93人围观）

还没有评论，来说两句吧...

相关阅读

相关 IDEA中使用GIT cherrypick

平时用GIT的COMMIT、PUSH比较多，没用过cherrypick，最近发现在IDEA的GIT工具栏里用cherrypick很方便。写篇文章记录，安利给大家。往基线分支

叁歲伎倆/ 2023年09月25日 20:59/ 0 赞/ 64 阅读

相关 Git使用教程

Git使用教程本篇文章主要介绍如何使用Git进行版本控制。文章目录 Git使用教程一、什么是Git 二、简单使用Git

雨点打透心脏的1/2处/ 2023年02月28日 01:47/ 0 赞/ 152 阅读

相关 git 使用教程

git 使用教程初始化本地仓库 $ git init 配置仓库信息 $ git config --global user.mail "email@

╰半夏微凉°/ 2022年11月29日 05:33/ 0 赞/ 22 阅读

相关 Git 使用教程

介绍 Git --- The stupid content tracker, 傻瓜内容跟踪器。Linus 是这样给我们介绍 Git 的。 Git 是用于 Linux 内

桃扇骨/ 2022年06月08日 04:24/ 0 赞/ 316 阅读

相关 Git使用教程

文章目录前言一、Git 基础 1.1 版本控制系统 1.2 安装 Git 1

浅浅的花香味﹌/ 2022年06月08日 03:06/ 0 赞/ 309 阅读

相关 Git使用教程

1、为什么要使用Git？ Git是目前世界上最先进的分布式版本控制系统，那么什么是版本控制系统呢？比如：在使用Word时，你一定遇到这样的情况：想删除一个段落，又怕将

布满荆棘的人生/ 2022年05月29日 11:23/ 0 赞/ 305 阅读

相关 Git 使用教程

git 提交全部文件 git add . git add xx命令可以将xx文件添加到暂存区，如果有很多改动可以通过 git add -A .来一次添加所有改变的文件

旧城等待，/ 2022年05月14日 02:18/ 0 赞/ 317 阅读

相关 git使用教程

[https://blog.csdn.net/youzhouliu/article/details/78952453][https_blog.csdn.net_y

青旅半醒/ 2022年05月12日 02:22/ 0 赞/ 263 阅读

相关 Git使用教程

一：Git是什么？ Git是目前世界上最先进的分布式版本控制系统。二：SVN与Git的最主要的区别？ SVN是集中式版本控制系统，版本库是集中放在中央服务器的，

我就是我/ 2022年03月08日 10:20/ 0 赞/ 285 阅读

相关 git分支合并并拉新分支 cherryPick

Git cherry-pick学习与交在某分支a上共提交了8次，因为特定原因只需要上线其中第一和第六次提交的内容针对这种场景，最好的方式就是Git 提供的che

快来打我*/ 2022年02月14日 10:43/ 0 赞/ 422 阅读