重写提交历史

在版本控制系统中，提交历史是项目演变的记录。有时需要修改历史记录，比如合并多个提交、修改提交信息或删除敏感信息。Git提供了多种工具来实现这些操作，但需谨慎使用以避免协作问题。

修改最后一次提交

git commit --amend是最简单的历史修改方式，它允许修改最近一次提交的内容或信息。例如，忘记添加文件或需要修正提交信息时：

# 修改提交信息
git commit --amend -m "新的提交信息"

# 添加漏掉的文件
git add missed_file.js
git commit --amend --no-edit

--no-edit表示保持原提交信息不变。注意：这会生成新的提交哈希，影响后续基于原提交的工作。

交互式变基

git rebase -i是更强大的工具，可以修改多个提交。以下操作需要指定基准点：

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

编辑器会打开类似如下的界面：

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

通过修改关键词实现不同操作：

• reword：仅修改提交信息
• edit：暂停变基以修改提交内容
• squash：将提交合并到前一个提交
• fixup：类似squash但丢弃提交信息
• drop：删除提交

合并提交示例

将三个提交合并为一个：

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

保存后会进入提交信息编辑界面，可重新编写合并后的信息。

拆分提交

使用edit拆分提交：

1. 标记要拆分的提交为edit
2. 变基暂停时执行git reset HEAD~
3. 重新添加文件并提交
4. 完成变基：git rebase --continue

修改历史中的文件内容

git filter-branch可批量修改历史中的文件，但性能较差。更推荐使用git filter-repo：

# 删除所有历史中的config.json文件
git filter-repo --path config.json --invert-paths

# 替换所有历史中的邮箱地址
git filter-repo --mailmap my-mailmap.txt

强制推送的注意事项

修改历史后需git push --force，但协作环境中应使用--force-with-lease更安全：

git push --force-with-lease origin main

这会检查远程分支是否被他人修改，避免覆盖他人提交。

恢复误操作

修改历史有风险，可通过以下方式恢复：

# 查看操作记录
git reflog

# 重置到指定操作
git reset --hard HEAD@{2}

实际应用场景

场景一：清理开发分支

开发过程中可能有多个"WIP"提交，合并前可整理：

git rebase -i origin/main
# 将多个提交合并为有意义的几个

场景二：敏感信息泄露

若意外提交了API密钥：

git filter-repo --replace-text <(echo "OLD_API_KEY==>NEW_API_KEY")

场景三：标准化提交信息

使用reword统一团队提交信息格式：

reword a1b2c3d feat: 添加用户登录
reword e4f5g6h fix: 修复登录跳转

高级技巧

使用提交钩子自动化

在.git/hooks/prepare-commit-msg中添加脚本自动格式化信息：

#!/bin/sh
echo "[$(date +%Y-%m-%d)] $(cat $1)" > $1

可视化工具辅助

对于复杂历史，使用tig或gitk可视化工具更直观：

tig --all

团队协作规范

1. 禁止修改已推送的公共分支历史
2. 个人分支整理后需通知团队成员
3. 重要分支修改前创建备份标签
4. 使用--force-with-lease而非--force

git tag backup-before-rebase
git push origin backup-before-rebase