Skip to content

Cherry-Pick 提交

中等 约 30 分钟

你将构建什么

一个场景:提交到特性分支的 bug 修复被 cherry-pick 到 main 和发布分支,而无需合并整个特性。

学习目标

  • 按哈希 cherry-pick 单个提交
  • Cherry-pick 一系列提交
  • 解决 cherry-pick 期间的冲突
  • 理解何时用 cherry-pick 而非 merge

前置要求

  • 基础 Git 提交与分支
  • 提交哈希(git log)
  • 冲突解决基础

步骤

  1. 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. 2

    Cherry-pick 修复到 main

    切换到 main 并按哈希 cherry-pick bug 修复提交。Git 仅应用该提交的更改,在 main 上创建新提交。

  3. 3

    Cherry-pick 到发布分支

    从较旧提交创建发布分支(如 release/v1.2)。将同一修复 cherry-pick 过去,使已发布版本也获得 bug 修复。

  4. 4

    处理冲突

    若 cherry-pick 冲突(目标分支周围代码不同),Git 暂停。解决冲突、git add 文件并 git cherry-pick --continue。

  5. 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

    预期结果

    范围内的所有提交都出现在目标分支。

自己动手试试

你学到了什么

你学会了 cherry-pick——跨分支应用特定提交的外科手术工具,对维护发布分支和向后移植修复至关重要。

相关资源

相关课程

  • 分支

    Cherry-pick 在分支间移动提交。

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题