git cherry-pick 拣选命令——重放提交
语法
git cherry-pick [<选项> …] <commit>…
git cherry-pick (--continue | --skip | --abort | --quit)
提示:方括号 [ ]
表示可选,...
表示可以有多项。
描述
给定一个或多个现有提交,将每个提交引入的更改应用到当前提交上,为每个提交记录一个新提交。这需要您的工作区是干净的(没有修改)。
如果发生冲突:
-
① 当前分支和 HEAD 指针保持在上次成功提交的位置;
-
② CHERRY_PICK_HEAD
引用被设置为指向引入了难以应用的更改的提交;
-
③ 干净地应用更改的路径会在暂存区和工作区中更新;
-
④ 对于冲突路径,工作区文件将包含冲突的描述,用通常的冲突标记 <<<<<<<
和 >>>>>>>
括起来。;
-
⑤ 没有做其他修改。
<commit>... ——提交或提交集
可以传递提交集,但默认情况下不进行遍历,即只拣选单个提交而不是包括其历史提交。但是一旦传递了提交集,则将进行遍历。可参考《git log 日志命令——显示提交日志》中的版本范围表示。
例子:
git cherry-pick master
将 master 分支的最后一次提交所引入的更改应用到当前提交,并使用此更改创建一个新的提交。
git cherry-pick dev test
将 dev 分支和 test 分支的最后一次提交所引入的更改应用到当前提交,并使用此更改创建两个新的提交。
注意,这里 dev 和 test 都是单个提交,不进行遍历。
git cherry-pick dev ^test
将 dev 分支的所有历史提交但不是 test 分支的历史提交(dev 和 test 的历史提交的差集)所引入的更改应用到当前提交,并使用此更改创建多个新的提交。
注意,这里 ^test 表示排除 test 及其历史提交,是一个提交集,因此 dev 将被遍历而不再是表示单个提交,dev 在此被解释为 dev 及其历史提交。
-e --edit 选项——提交前编辑提交信息
有了这个选项,git cherry-pick 将允许你在提交之前编辑提交消息。
-x 选项——附加提交信息
在记录提交时,在原始的提交消息后添加一行 “(cherry picked from commit...)” ,以表明这个更改是从哪个提交中被选中的。
--continue 选项——继续拣选
用于解决冲突后继续进行拣选操作。
--skip 选项——跳过冲突提交
跳过当前冲突的提交,继续进行拣选操作。
--abort 选项——取消拣选
取消拣选操作,返回拣选前的状态。