编辑“︁Git重写历史”︁

= Git重写历史 =

'''Git重写历史'''是指通过修改提交记录来改变版本库的历史状态。这项高级操作允许开发者整理提交记录、修复错误信息或清理敏感数据，但需谨慎使用以避免协作问题。本指南将详细介绍重写历史的原理、常用命令及实际应用场景。

== 核心概念 ==

Git的历史记录本质上是不可变的——每个提交都通过SHA-1哈希唯一标识。所谓"重写历史"实际上是创建新的提交链替代原有记录。主要应用场景包括：

* 修改最近提交的消息（commit message）
* 合并/拆分提交
* 删除敏感信息（如密码）
* 清理中间调试步骤
* 规范提交结构

{{Warning|重写已推送的历史会破坏团队协作！仅对未推送的本地分支或私有分支执行此操作}}

== 基础操作 ==

=== 修改最近提交 ===

使用<code>git commit --amend</code>可修改最后一次提交：

<syntaxhighlight lang="bash">
# 1. 修改文件后暂存
git add .
# 2. 修改提交消息（不添加-m参数会打开编辑器）
git commit --amend -m "新的提交消息"
# 3. 强制推送到远程分支（仅限私有分支！）
git push --force
</syntaxhighlight>

=== 交互式变基 ===

<code>git rebase -i</code>允许批量修改历史记录：

<syntaxhighlight lang="bash">
# 修改最近3次提交
git rebase -i HEAD~3
</syntaxhighlight>

编辑器会显示操作列表（旧→新排序）：

<syntaxhighlight>
pick a1b2c3d 第一次提交
pick e4f5g6h 第二次提交
pick i7j8k9l 第三次提交

# 可用的操作指令：
# p/pick = 使用提交
# r/reword = 修改提交消息
# e/edit = 修改提交内容
# s/squash = 合并到前一个提交
# f/fixup = 类似squash但丢弃消息
# d/drop = 删除提交
</syntaxhighlight>

== 高级技巧 ==

=== 删除敏感文件 ===

使用<code>git filter-branch</code>从所有历史中删除文件：

<syntaxhighlight lang="bash">
git filter-branch --force --index-filter \
  'git rm --cached --ignore-unmatch 密码文件.txt' \
  --prune-empty --tag-name-filter cat -- --all
</syntaxhighlight>

=== 修改作者信息 ===

修正全局作者信息（适用于迁移仓库时）：

<syntaxhighlight lang="bash">
git filter-branch --env-filter '
OLD_EMAIL="old@example.com"
CORRECT_NAME="New Name"
CORRECT_EMAIL="new@example.com"
if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_COMMITTER_NAME="$CORRECT_NAME"
    export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_AUTHOR_NAME="$CORRECT_NAME"
    export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
fi
' --tag-name-filter cat -- --all
</syntaxhighlight>

== 工作流示例 ==

=== 案例1：整理功能分支 ===

初始提交历史：

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

执行交互式变基合并多余提交：

<syntaxhighlight lang="bash">
git checkout feature
git rebase -i HEAD~4  # 合并最后4个提交
# 将后3个提交标记为"squash"
</syntaxhighlight>

整理后历史：

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

=== 案例2：紧急修复敏感信息泄露 ===

1. 使用<code>git filter-branch</code>删除文件
2. 强制推送所有分支：
   <syntaxhighlight lang="bash">
   git push origin --force --all
   git push origin --force --tags
   </syntaxhighlight>
3. 通知所有协作者重新克隆仓库

== 数学原理 ==

Git的提交链可表示为有向无环图（DAG），其中每个提交包含：

<math>
C_i = (T_i, P_i, M_i, H_i)
</math>

* <math>T_i</math>：提交时间
* <math>P_i</math>：父提交集合
* <math>M_i</math>：提交消息
* <math>H_i</math>：内容哈希

重写历史即构造新图<math>G' = (V', E')</math>，使得：

<math>
\forall c' \in V', \exists f(c') \in V \text{ 满足 } H(f(c')) \equiv H'(c')
</math>

其中<math>f</math>为内容等价映射函数。

== 风险与最佳实践 ==

'''强制推送的风险矩阵：'''

{| class="wikitable"
! 操作类型 !! 个人分支 !! 共享分支
|-
| 添加新提交 || 安全 || 安全
|-
| 非快进推送 || 中等风险 || 高风险
|-
| 历史重写 || 低风险 || '''严禁'''
|}

'''推荐工作流：'''
1. 使用<code>--force-with-lease</code>而非<code>--force</code>
2. 重要分支启用分支保护
3. 团队沟通历史修改计划
4. 考虑使用<code>git revert</code>而非重写

== 替代方案 ==

对于共享分支，优先考虑：
* <code>git revert</code>创建逆向提交
* 使用<code>git merge --squash</code>简化历史
* 新建修复提交而非修改历史

[[Category:Git高级操作]]
[[Category:版本控制]]
[[Category:软件开发工具]]

[[Category:集成部署]]
[[Category:Git]]