编辑“︁Git变基深入”︁

= Git变基深入 =

== 介绍 ==
'''Git变基（Rebase）'''是Git版本控制系统中一项高级操作，用于重新整理提交历史。与'''合并（Merge）'''不同，变基通过将分支的提交“重新播放”到另一个分支上，使历史记录更加线性、整洁。变基常用于以下场景：
* 保持主分支历史清晰
* 解决分支间的冲突
* 整理本地未推送的提交

注意：变基会改写提交历史，因此'''已共享的提交不应变基'''（遵循[https://git-scm.com/book/en/v2/Git-Branching-Rebasing#_rebase_peril Git黄金法则]）。

== 基础变基操作 ==
=== 交互式变基 ===
使用<code>git rebase -i</code>可交互式修改提交：
<syntaxhighlight lang="bash">
# 修改最近3个提交
git rebase -i HEAD~3
</syntaxhighlight>

编辑器会显示（示例）：
<syntaxhighlight>
pick 1a2b3c Commit message 1
pick 4d5e6f Commit message 2
pick 7g8h9i Commit message 3
</syntaxhighlight>

可用的操作命令：
* '''pick'''：保留提交
* '''reword'''：修改提交信息
* '''edit'''：暂停变基以修改提交内容
* '''squash'''：将提交合并到前一个提交
* '''drop'''：删除提交

=== 分支变基 ===
将feature分支变基到main分支：
<syntaxhighlight lang="bash">
git checkout feature
git rebase main
</syntaxhighlight>

<mermaid>
gitGraph
    commit
    branch feature
    checkout feature
    commit
    commit
    checkout main
    commit
    checkout feature
    rebase main
</mermaid>

== 高级应用 ==
=== 解决冲突 ===
变基过程中可能出现冲突，解决步骤：
1. 冲突文件会显示冲突标记
2. 编辑文件解决冲突
3. 使用<code>git add</code>标记为已解决
4. 继续变基：<code>git rebase --continue</code>
5. 或中止变基：<code>git rebase --abort</code>

=== 修改历史提交 ===
通过<code>edit</code>操作可修改旧提交：
<syntaxhighlight lang="bash">
# 1. 启动交互式变基
git rebase -i HEAD~3

# 2. 将目标提交标记为edit
edit 1a2b3c Target commit

# 3. 修改文件后
git add .
git commit --amend

# 4. 继续变基
git rebase --continue
</syntaxhighlight>

== 数学原理 ==
变基实质是提交的'''线性变换'''。设原始提交链为向量<math>\vec{C} = (c_1, c_2, ..., c_n)</math>，变基后：
<math>\vec{C'} = T \cdot \vec{C}</math>
其中变换矩阵<math>T</math>包含：
* 保留操作 → 单位矩阵元素
* 压缩操作 → 行合并
* 删除操作 → 行移除

== 实际案例 ==
=== 案例1：整理功能分支 ===
'''场景'''：开发功能时频繁提交了"WIP"（Work In Progress）中间提交

'''解决方案'''：
<syntaxhighlight lang="bash">
# 压缩多个WIP提交
git rebase -i origin/main

# 将多个pick改为squash
pick 1a2b3c Feature: Add user API
squash 4d5e6f WIP: debugging
squash 7g8h9i WIP: more tests
</syntaxhighlight>

=== 案例2：同步上游更改 ===
'''场景'''：fork的项目需要同步原仓库的更新

'''解决方案'''：
<syntaxhighlight lang="bash">
git remote add upstream <原仓库URL>
git fetch upstream
git rebase upstream/main
</syntaxhighlight>

== 注意事项 ==
* '''不要'''变基已推送到公共仓库的提交
* 变基后需强制推送：<code>git push --force-with-lease</code>
* 复杂变基建议在备份分支操作
* 团队协作时应明确变基策略

== 最佳实践 ==
1. 本地功能分支定期变基主分支
2. 推送前用<code>git log --graph</code>检查历史
3. 配置<code>pull.rebase = true</code>避免多余合并提交
4. 使用<code>--force-with-lease</code>而非<code>--force</code>推送

== 常见问题 ==
'''Q：变基和合并有何区别？'''
{| class="wikitable"
|-
! 变基 (Rebase) !! 合并 (Merge)
|-
| 历史线性清晰 || 保留实际开发过程
|-
| 适合本地未共享提交 || 适合公共分支集成
|-
| 需要解决冲突一次 || 可能多次解决相同冲突
|}

'''Q：变基丢失了提交怎么办？'''
使用<code>git reflog</code>找回丢失的提交引用。

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