Git重写历史[编辑 | 编辑源代码]

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

核心概念[编辑 | 编辑源代码]

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

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

基础操作[编辑 | 编辑源代码]

修改最近提交[编辑 | 编辑源代码]

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

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

交互式变基[编辑 | 编辑源代码]

git rebase -i允许批量修改历史记录：

# 修改最近3次提交
git rebase -i HEAD~3

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

pick a1b2c3d 第一次提交
pick e4f5g6h 第二次提交
pick i7j8k9l 第三次提交

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

高级技巧[编辑 | 编辑源代码]

删除敏感文件[编辑 | 编辑源代码]

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

git filter-branch --force --index-filter \
  'git rm --cached --ignore-unmatch 密码文件.txt' \
  --prune-empty --tag-name-filter cat -- --all

修改作者信息[编辑 | 编辑源代码]

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

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

工作流示例[编辑 | 编辑源代码]

案例1：整理功能分支[编辑 | 编辑源代码]

初始提交历史：

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

git checkout feature
git rebase -i HEAD~4  # 合并最后4个提交
# 将后3个提交标记为"squash"

整理后历史：

案例2：紧急修复敏感信息泄露[编辑 | 编辑源代码]

1. 使用git filter-branch删除文件 2. 强制推送所有分支：

   git push origin --force --all
   git push origin --force --tags

3. 通知所有协作者重新克隆仓库

数学原理[编辑 | 编辑源代码]

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

$C_{i} = (T_{i}, P_{i}, M_{i}, H_{i})$

$T_{i}$ ：提交时间
$P_{i}$ ：父提交集合
$M_{i}$ ：提交消息
$H_{i}$ ：内容哈希

重写历史即构造新图 $G^{'} = (V^{'}, E^{'})$ ，使得：

$\forall c^{'} \in V^{'}, \exists f (c^{'}) \in V 满足 H (f (c^{'})) \equiv H^{'} (c^{'})$

其中 $f$ 为内容等价映射函数。

风险与最佳实践[编辑 | 编辑源代码]

强制推送的风险矩阵：

操作类型	个人分支	共享分支
添加新提交	安全	安全
非快进推送	中等风险	高风险
历史重写	低风险	严禁

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

替代方案[编辑 | 编辑源代码]

对于共享分支，优先考虑：

git revert创建逆向提交
使用git merge --squash简化历史
新建修复提交而非修改历史