版本控制与协作 / 系统课时
挑选单个提交
挑选单个提交
学习目标
完成本课后,你将能够:
- 使用 cherry-pick 复制指定提交变化
- 理解新提交会获得不同标识
- 处理挑选过程中的冲突与中止
问题背景或应用场景
有时某个修复提交位于另一个分支,但当前分支只需要这一项变化,不适合合并整条分支。cherry-pick 可以把指定提交的差异应用到当前分支并创建新提交。
核心原理
cherry-pick 复制的是提交产生的变化和元数据,不是把原提交对象直接移动过来。由于父提交不同,新提交通常具有不同哈希。它适合移植独立修复,但频繁使用可能造成同一逻辑在多个分支重复存在。
发生冲突时,Git 会暂停并保留操作状态。解决后执行 git cherry-pick --continue;确认不应继续时使用 --abort 返回操作前状态。
基础用法
先用 git show <提交> 确认差异和依赖,再切换到目标分支执行 git cherry-pick <提交>。完成后检查日志、文件和测试结果。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-cherry-pick-demo
mkdir git-cherry-pick-demo
cd git-cherry-pick-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base
" > app.txt
git add app.txt
git commit -q -m "feat: add base"
git switch -q -c fix
printf "base
fix enabled
" > app.txt
git add app.txt
git commit -q -m "fix: enable validation"
fix_commit=$(git rev-parse HEAD)
git switch -q main
git cherry-pick "$fix_commit" >/dev/null 2>&1
printf "file:
"
cat app.txt
printf "history:
"
git log --format=%s --reverse预期输出
text
file:
base
fix enabled
history:
feat: add base
fix: enable validationTips
- 挑选前检查提交是否依赖更早提交。
- 同一提交不要在将来又通过整分支合并重复引入。
- 多个连续提交可按原顺序逐个挑选。
常见错误
1. 挑选依赖不完整的提交
- 错误表现:代码编译失败或缺少文件。
- 产生原因:目标提交依赖未一起移植的前置提交。
- 正确处理:检查提交历史与差异,补充必要提交或改用合并。
- 修复结果:目标分支具备完整依赖。
2. 冲突时重新执行 cherry-pick
- 错误表现:操作状态更加混乱。
- 产生原因:未使用 continue 或 abort 完成当前序列。
- 正确处理:先解决当前冲突,再执行
--continue;放弃则--abort。 - 修复结果:仓库退出挑选中间状态。
本课练习
1. 移植文档提交
- 任务目标:练习独立提交。
- 输入或初始条件:文档提交位于
docs分支。 - 实现要求:挑选到
main。 - 验收条件:主分支新增文档且没有其他分支改动。
2. 挑选连续提交
- 任务目标:保持依赖顺序。
- 输入或初始条件:功能由两个连续提交组成。
- 实现要求:按顺序挑选。
- 验收条件:目标分支测试通过且日志顺序正确。
3. 中止冲突挑选
- 任务目标:练习安全退出。
- 输入或初始条件:构造同一行冲突。
- 实现要求:执行挑选后中止。
- 验收条件:工作区和 HEAD 恢复操作前状态。
按自己的节奏,确认真正理解。