如何把某一个 commit 合并到当前分支？Git cherry-pick 完整教程

如何把某一个 commit 合并到当前分支Git cherry-pick 完整教程在实际开发中我们经常会遇到这样的情况另一个分支中有很多提交但当前分支只需要其中某一个 commit。这种情况下没有必要把整个分支merge进来直接使用git cherry-pick就可以把指定提交带到当前分支。一、先说结论使用 git cherry-pick假设现在有两个分支main当前稳定分支feature功能开发分支feature分支上已经产生了多个 commit但你只想把其中某一个提交合并到main。这时先切换到接收提交的目标分支然后执行gitcherry-pickcommit-idcherry-pick的核心并不是把另一个分支整体合并过来而是把指定 commit 所引入的改动重新应用到当前分支并在当前分支上生成一个新的提交。可以简单记成一句话merge 是合分支cherry-pick 是挑提交。二、什么情况下应该用 cherry-pickgit cherry-pick最适合“我只需要这一条提交”的场景。实际开发中比较常见的情况有某个 Bug 已经在dev分支修复现在需要快速同步到main或release。一个功能分支中有很多 commit但当前分支只需要其中一个。某个 commit 提交到了错误分支需要把它带到正确分支。线上完成了一个 Hotfix需要把同样的修复同步到其他维护分支。如果你的需求是把整个功能分支一起合并那么通常应该使用git merge如果只想拿其中某一个提交cherry-pick会更加合适。三、完整操作把某一个 commit 合并到当前分支下面直接用一个完整例子说明。假设需要的 commit 位于feature分支而最终希望把它放进main分支。1. 先确认当前分支首先查看当前仓库有哪些分支gitbranch如果当前不在main先切换到maingitswitch main较老版本的 Git 也可以使用gitcheckout main这里一定要注意git cherry-pick会把指定 commit 的改动应用到当前分支。所以执行之前一定要先确认自己现在站在哪个分支上否则很容易把提交放错地方。2. 检查工作区状态执行cherry-pick之前建议先查看当前工作区gitstatus如果还有尚未处理的本地修改最好先提交、暂存或妥善保存再进行cherry-pick。这样可以避免当前修改和目标 commit 的改动混在一起减少冲突和误操作。3. 找到目标 commit ID查看提交历史gitlog--oneline--all--graph--decorate假设看到a72c91f fix: 修复登录状态失效问题 3bd5e84 feat: 新增用户头像上传 1f26a77 refactor: 重构用户服务现在我们只需要第一条修复提交那么目标 commit ID 就是a72c91f一般情况下Git 显示出来的短 commit ID 就可以直接使用只要它能够在当前仓库中唯一定位到对应提交。4. 执行 cherry-pick确认当前已经处于main分支以后执行gitcherry-pick a72c91f如果没有发生冲突Git 会直接把这个 commit 引入的改动应用到当前分支并自动创建一个新的提交。整个标准流程可以看下面这张图5. 检查是否成功查看最近几条提交记录gitlog--oneline-5再检查当前工作区gitstatus如果提交记录已经出现并且工作区状态正常那么这次cherry-pick就完成了。四、为什么 cherry-pick 以后 commit ID 变了很多人第一次使用cherry-pick时会发现一个问题明明是同一个提交为什么进入当前分支之后 commit ID 变了这是正常现象。cherry-pick并不是把原来的 commit 对象原封不动地搬到当前分支而是把这个 commit 引入的代码改动重新应用一次然后在当前分支创建新的提交。新的提交和原提交的父提交关系通常不同因此生成的新 commit ID 通常也会不同。所以判断cherry-pick是否成功时不要只看 commit ID 是否一样更重要的是检查目标代码改动是否已经进入当前分支。当前分支是否生成了对应的新提交。git status是否正常。五、cherry-pick 发生冲突怎么办如果目标 commit 修改的代码与当前分支中的代码已经产生较大差异Git 可能无法自动完成合并。这时cherry-pick会暂停并提示发生冲突。先查看当前状态gitstatus打开冲突文件手动处理冲突。解决完成以后把处理好的文件加入暂存区gitadd.然后继续执行gitcherry-pick--continue注意这时候不要重新执行原来的git cherry-pick commit-id。正确流程是发生冲突 ↓ 手动解决冲突 ↓ git add . ↓ git cherry-pick --continue六、不想继续 cherry-pick 了怎么办如果执行到一半发现选错 commit或者冲突过于复杂希望直接取消这一次操作可以执行gitcherry-pick--abortGit 会尝试把仓库恢复到这次cherry-pick开始之前的状态。如果正在连续cherry-pick多个提交并且当前这个提交不想继续应用可以使用gitcherry-pick--skip这几个命令可以这样记命令作用git cherry-pick --continue冲突解决后继续git cherry-pick --abort放弃本次 cherry-pickgit cherry-pick --skip跳过当前提交七、cherry-pick 完才发现选错 commit怎么撤销这里需要区分提交是否已经推送到了远程仓库。情况 1刚执行完还没有 push如果确定刚刚cherry-pick生成的就是最近一个 commit而且还没有共享给别人可以退回上一个提交gitreset--hardHEAD~1但是要特别注意--hard会同时重置提交、暂存区和工作区。如果工作区还有没有保存的重要内容可能会直接丢失因此执行前一定要确认当前修改是否需要保留。情况 2已经 push 到远程仓库如果这个提交已经被推送到公共分支一般不建议直接使用reset --hard改写共享历史。先查看提交记录gitlog--oneline找到cherry-pick后新生成的 commit ID然后执行gitrevertnew-commit-idrevert会创建一个新的反向提交用新的 commit 撤销原提交带来的修改而不是直接把已有历史删除。这种方式更适合团队协作中的公共分支。八、一次 cherry-pick 多个 commit虽然本文重点讲的是“某一个 commit”但实际开发中也可能需要挑选多个提交。多个不连续的 commit 可以直接写在命令后面gitcherry-pick a72c91f 3bd5e84 1f26a77Git 会按照给出的顺序依次应用这些提交。如果要选择一段连续的 commit可以使用提交范围gitcherry-pick A^..B这种写法表示把从A到B的这一段提交应用到当前分支其中包含A和B。如果中途某一个 commit 发生冲突整个过程会暂停。解决冲突以后执行gitcherry-pick--continueGit 才会继续处理后面的提交。九、cherry-pick 和 merge 到底有什么区别这是最容易混淆的地方。简单对比一下对比项git mergegit cherry-pick操作对象整个分支指定 commit是否自动带入其他提交通常会不会自动带入提交历史体现分支合并关系在当前分支生成新的提交典型场景功能分支整体合并只拿一个修复或小功能核心思路合分支挑提交一句话记忆merge 把分支合进来。cherry-pick 从提交历史里摘一个 commit 过来。十、实际开发案例假设团队现在有两个分支main feature/loginfeature/login中产生了三个 commit8a11c30 feat: 新增登录页面 91bd722 fix: 修复 token 过期判断 c3a8f05 feat: 新增第三方登录现在main分支只急需token修复并不想把登录页面和第三方登录功能一起带进去。先切换到maingitswitch main检查工作区gitstatus然后只选择修复提交gitcherry-pick 91bd722最后查看提交历史gitlog--oneline-5这样main只会得到91bd722所引入的代码改动而另外两个功能 commit 不会因为这次操作自动进入main。这就是cherry-pick最典型的使用场景。十一、最容易踩的几个坑1. 当前分支切错了这是最常见的问题。记住谁要接收这个 commit就先切换到谁。例如需要把某个提交合到maingitswitch main然后再执行cherry-pick。2. 工作区还有未提交修改执行前先检查gitstatus不要让正在开发但还没处理的代码与cherry-pick的改动混在一起。3. 冲突以后又重新执行 cherry-pick错误思路冲突以后再次执行gitcherry-pickcommit-id正确做法是解决冲突后gitadd.gitcherry-pick--continue4. 看到 commit ID 不一样就认为失败了cherry-pick后通常会生成新的 commit因此 commit ID 变化并不代表失败。重点检查代码改动和提交记录是否正确。5. 已经 push 以后随便 reset --hard如果已经推送到公共分支直接改写提交历史可能影响其他协作者。这种情况下通常更适合gitrevertcommit-id6. 整个功能都需要却一个一个 cherry-pick如果你最终就是需要整个功能分支那么通常直接merge更合理。如果几十个 commit 全靠cherry-pick一个个挑提交历史反而容易变得难以理解和维护。十二、常用命令速查查看当前状态gitstatus查看提交历史gitlog--oneline--all--graph--decorate切换目标分支gitswitch main挑选一个 commitgitcherry-pickcommit-id冲突解决后继续gitcherry-pick--continue放弃本次操作gitcherry-pick--abort跳过当前提交gitcherry-pick--skip撤销已经共享出去的提交gitrevertnew-commit-id十三、总结如果你的需求是只把另一个分支中的某一个 commit 合并到当前分支。最直接的方案就是gitswitchtarget-branchgitcherry-pickcommit-id实际操作时可以记住下面四步先切到接收提交的目标分支。找到需要的 commit ID。执行git cherry-pick commit-id。使用git log和git status检查结果。最重要的一点是cherry-pick 操作的是 commit不是整个分支。只要把这一点理解清楚什么时候应该用merge什么时候应该用cherry-pick基本就不会搞混了。参考资料Git 官方文档git-cherry-pick DocumentationGit 官方文档地址https://git-scm.com/docs/git-cherry-pick