Cherry-Pick 提交
你将构建什么
一个场景:提交到特性分支的 bug 修复被 cherry-pick 到 main 和发布分支,而无需合并整个特性。
学习目标
- 按哈希 cherry-pick 单个提交
- Cherry-pick 一系列提交
- 解决 cherry-pick 期间的冲突
- 理解何时用 cherry-pick 而非 merge
前置要求
- 基础 Git 提交与分支
- 提交哈希(git log)
- 冲突解决基础
步骤
- 1
创建含共享 bug 的分支
创建含若干提交的特性分支,其中一个是 bug 修复。你想立即将该修复放到 main,而不要其余特性。
代码git checkout -b feature/big-feature echo 'feature work' >> feature.js && git add . && git commit -m 'Add feature' echo 'bug fix' >> bug.js && git add . && git commit -m 'Fix critical bug' git log --oneline # note the hash of 'Fix critical bug'预期结果
一个含至少 2 个提交的特性分支;你已记录 bug 修复哈希。
- 2
Cherry-pick 修复到 main
切换到 main 并按哈希 cherry-pick bug 修复提交。Git 仅应用该提交的更改,在 main 上创建新提交。
提示
被 cherry-pick 的提交在 main 上获得新哈希,但更改和消息相同。
- 3
Cherry-pick 到发布分支
从较旧提交创建发布分支(如 release/v1.2)。将同一修复 cherry-pick 过去,使已发布版本也获得 bug 修复。
提示
用 git checkout -b release/v1.2 <old-commit> 然后 git cherry-pick <fix-hash>。
- 4
处理冲突
若 cherry-pick 冲突(目标分支周围代码不同),Git 暂停。解决冲突、git add 文件并 git cherry-pick --continue。
提示
若想中止 cherry-pick,运行 git cherry-pick --abort 返回之前状态。
- 5
Cherry-pick 一系列提交
用 git cherry-pick A..B 一次 cherry-pick 多个提交(不含 A,含 B)。验证所有提交都到了目标分支。
代码git cherry-pick <hash-A>..<hash-B> git log --oneline # all commits in the range are now on this branch预期结果
范围内的所有提交都出现在目标分支。
自己动手试试
# Run the commands above in a test repositorygit cherry-pick <commit-hash>你学到了什么
你学会了 cherry-pick——跨分支应用特定提交的外科手术工具,对维护发布分支和向后移植修复至关重要。
相关资源
相关课程
- 分支
Cherry-pick 在分支间移动提交。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。