编辑“︁Git交互式变基”︁

= Git交互式变基 =

'''Git交互式变基'''（Interactive Rebase）是Git版本控制系统中用于修改提交历史的强大工具。它允许用户重新排序、编辑、合并或删除提交记录，从而创建更清晰、更有逻辑性的项目历史。与常规变基不同，交互式变基提供了精细控制，适合需要整理提交记录的场景。

== 基本概念 ==

交互式变基通过<code>git rebase -i</code>命令启动，其后跟随目标提交的引用（如分支名、标签或提交哈希）。执行后，Git会打开一个编辑器，列出范围内的所有提交，并提供操作选项（如<code>pick</code>、<code>reword</code>、<code>edit</code>等）。用户可通过修改这些选项来定制历史记录。

=== 核心操作选项 ===
* '''pick'''（或缩写<code>p</code>）：保留提交（默认操作）。
* '''reword'''（<code>r</code>）：保留提交内容但修改提交消息。
* '''edit'''（<code>e</code>）：暂停变基以修改提交内容或拆分为多个提交。
* '''squash'''（<code>s</code>）：将提交合并到前一个提交中，并组合提交消息。
* '''fixup'''（<code>f</code>）：类似<code>squash</code>，但丢弃当前提交的消息。
* '''drop'''（<code>d</code>）：删除提交。

== 操作示例 ==

以下示例演示如何将最近的3个提交合并为1个提交：

<syntaxhighlight lang="bash">
# 启动交互式变基（以HEAD~3为起点）
git rebase -i HEAD~3
</syntaxhighlight>

编辑器将显示类似内容：
<syntaxhighlight>
pick a1b2c3d Commit 1
pick e4f5g6h Commit 2
pick i7j8k9l Commit 3
</syntaxhighlight>

修改为：
<syntaxhighlight>
pick a1b2c3d Commit 1
squash e4f5g6h Commit 2
squash i7j8k9l Commit 3
</syntaxhighlight>

保存退出后，Git会提示编辑合并后的提交消息。

=== 输出结果 ===
通过<code>git log --oneline</code>可看到原来的3个提交已被合并为1个新提交：
<syntaxhighlight>
b0c1d2e (HEAD -> main) Combined commit message
...
</syntaxhighlight>

== 实际应用场景 ==

=== 场景1：清理琐碎提交 ===
开发过程中可能产生大量类似"Fix typo"的小提交。交互式变基可将它们合并为逻辑完整的更改单元：
<syntaxhighlight>
pick 1a2b3c Implement user login
squash 4d5e6f Fix typo in login.py
squash 7g8h9i Adjust login timeout
</syntaxhighlight>

=== 场景2：修改历史提交消息 ===
使用<code>reword</code>选项批量规范提交消息：
<syntaxhighlight>
reword 1a2b3c feat: add user login
reword 4d5e6f fix: resolve null pointer
</syntaxhighlight>

== 高级技巧 ==

=== 拆分提交 ===
通过<code>edit</code>选项可拆分提交：
1. 标记要拆分的提交为<code>edit</code>
2. 变基暂停时运行<code>git reset HEAD~</code>
3. 分阶段添加文件并创建新提交
4. 完成变基

=== 重新排序提交 ===
直接调整提交行的顺序即可改变历史顺序：
<syntaxhighlight>
pick 1a2b3c Feature B
pick 4d5e6f Feature A  # 将此行移到上一行之前
</syntaxhighlight>

== 注意事项 ==

* '''风险提示'''：交互式变基会重写历史，已推送的提交不应变基（除非团队明确允许）。
* '''冲突处理'''：变基过程中可能出现冲突，需手动解决后<code>git add</code>并<code>git rebase --continue</code>。
* '''撤销操作'''：若变基出错，可通过<code>git reflog</code>找到变基前的状态并重置。

== 可视化流程 ==

<mermaid>
gitGraph
    commit
    commit
    branch feature
    checkout feature
    commit
    commit
    commit
    checkout main
    commit
    commit
    git rebase -i main feature  # 交互式变基将feature分支的提交整理到main
</mermaid>

== 数学表示 ==

交互式变基可视为提交历史的函数变换：
<math>
f \colon \{C_1, C_2, \dots, C_n\} \to \{C'_1, C'_2, \dots, C'_m\}
</math>
其中：
* <math>n</math>为原始提交数
* <math>m</math>为变基后提交数（可能因合并/删除而不同）
* 每个<math>C'_i</math>是原始提交的某种组合或修改

== 总结 ==

Git交互式变基是项目历史管理的精密工具，特别适合：
* 准备清晰的可读历史供代码审查
* 将实验性开发转化为逻辑连贯的提交序列
* 遵循项目的提交规范整理本地更改

掌握此技术能显著提升版本控制效率，但需注意仅在本地未推送分支上安全使用。

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