编辑“︁Git Cherry-pic”︁

= Git Cherry-pick =

'''Git Cherry-pick''' 是一种高级 Git 操作，允许开发者选择性地将某个提交（commit）从一个分支应用到另一个分支，而不需要合并整个分支。这在需要将特定更改从一个分支移植到另一个分支时非常有用，尤其是在协作开发或修复 bug 时。

== 介绍 ==

Git Cherry-pick 的工作原理是提取某个提交的更改，并尝试将其应用到当前分支。它不会复制整个提交历史，而是仅应用该提交的差异（diff）。这使得它非常适合以下场景：
* 将某个 bug 修复提交从开发分支移植到稳定分支。
* 在多个分支之间共享特定的功能提交。
* 避免不必要的合并冲突，仅引入需要的更改。

=== 基本语法 ===

Git Cherry-pick 的基本语法如下：

<syntaxhighlight lang="bash">
git cherry-pick <commit-hash>
</syntaxhighlight>

其中，`<commit-hash>` 是要应用的提交的哈希值（SHA-1）。

== 使用示例 ==

=== 基础用法 ===

假设我们有以下提交历史（使用 `git log --oneline --graph` 查看）：

<mermaid>
gitGraph
    commit
    commit
    branch feature
    checkout feature
    commit
    commit id: "abc123" tag: "Important fix"
    commit
    checkout main
    commit
</mermaid>

我们希望将 `feature` 分支上的提交 `abc123`（标记为 "Important fix"）应用到 `main` 分支上。

1. 首先，切换到 `main` 分支：
<syntaxhighlight lang="bash">
git checkout main
</syntaxhighlight>

2. 然后，执行 cherry-pick：
<syntaxhighlight lang="bash">
git cherry-pick abc123
</syntaxhighlight>

如果操作成功，Git 会创建一个新的提交，其更改与 `abc123` 相同，但具有新的提交哈希值。

=== 处理冲突 ===

如果 cherry-pick 过程中发生冲突，Git 会暂停操作并提示你解决冲突。冲突文件会被标记为 "unmerged"，你需要手动编辑这些文件以解决冲突。解决冲突后，执行以下命令继续：

<syntaxhighlight lang="bash">
git add <conflicted-file>
git cherry-pick --continue
</syntaxhighlight>

如果希望取消 cherry-pick 操作，可以运行：
<syntaxhighlight lang="bash">
git cherry-pick --abort
</syntaxhighlight>

== 高级用法 ==

=== 选择多个提交 ===

可以一次 cherry-pick 多个提交，只需提供它们的哈希值（按时间顺序排列）：
<syntaxhighlight lang="bash">
git cherry-pick abc123 def456
</syntaxhighlight>

或者使用提交范围（注意：范围是左开右闭区间）：
<syntaxhighlight lang="bash">
git cherry-pick abc123..def456
</syntaxhighlight>

=== 不自动提交 ===

默认情况下，cherry-pick 会自动创建新提交。如果希望先检查更改，可以使用 `-n` 或 `--no-commit` 选项：
<syntaxhighlight lang="bash">
git cherry-pick -n abc123
</syntaxhighlight>

之后可以手动提交：
<syntaxhighlight lang="bash">
git commit -m "Apply important fix from feature branch"
</syntaxhighlight>

=== 编辑提交信息 ===

使用 `-e` 或 `--edit` 选项可以在应用提交时编辑提交信息：
<syntaxhighlight lang="bash">
git cherry-pick -e abc123
</syntaxhighlight>

== 实际案例 ==

=== 案例 1：修复跨分支的 bug ===

假设你在 `develop` 分支上修复了一个 bug（提交 `fix123`），但该 bug 也存在于 `main` 分支中。你可以通过 cherry-pick 将修复应用到 `main` 分支，而无需合并整个 `develop` 分支：

<syntaxhighlight lang="bash">
git checkout main
git cherry-pick fix123
</syntaxhighlight>

=== 案例 2：选择性移植功能 ===

假设 `feature/login` 分支上有多个提交，但你只想将其中一个功能提交（`feat456`）移植到 `main` 分支：
<syntaxhighlight lang="bash">
git checkout main
git cherry-pick feat456
</syntaxhighlight>

== 注意事项 ==

* Cherry-pick 会创建新的提交，因此原始提交和新提交的哈希值不同。
* 过度使用 cherry-pick 可能导致提交历史混乱，建议在必要时使用。
* 如果提交之间存在依赖关系，可能需要按顺序 cherry-pick 多个提交。
* 在团队协作中，应谨慎使用 cherry-pick，以避免与其他成员的更改冲突。

== 数学表示 ==

从数学角度看，cherry-pick 可以表示为：

<math>
\Delta = \text{diff}(C_{\text{parent}}, C_{\text{target}})
</math>

其中：
* <math>\Delta</math> 是要应用的更改。
* <math>C_{\text{parent}}</math> 是目标提交的父提交。
* <math>C_{\text{target}}</math> 是要 cherry-pick 的提交。

== 总结 ==

Git Cherry-pick 是一个强大的工具，可以灵活地管理代码更改。它特别适合需要选择性移植提交的场景，但应谨慎使用以避免历史混乱。通过本文的示例和解释，你应该能够掌握 cherry-pick 的基本和高级用法，并在实际开发中应用它。

[[Category:集成部署]]
[[Category:Git]]
[[Category:Git高级操作]]