如何重建Git提交历史并应用pre-commit钩子？

核心思路：用交互式rebase配合自定义脚本批量处理提交 #

git rebase是处理这类历史重写的最优工具，通过自定义脚本可自动触发pre-commit钩子、保留原始元数据，并处理钩子修改后的提交。

步骤1：准备环境 #

• 克隆原始仓库到本地，或在现有仓库新建分支用于重写：

  git clone <原始仓库URL>
  cd <仓库目录>
  git checkout -b rewrite-history
  

• 配置pre-commit钩子：确保.git/hooks/pre-commit脚本具备执行权限（chmod +x .git/hooks/pre-commit）；若使用pre-commit框架，先运行pre-commit install完成初始化。

步骤2：编写批量处理脚本 #

在仓库根目录创建process-commit.sh脚本，赋予执行权限：

#!/bin/bash

# 暂存当前提交的所有修改，确保钩子能检测到全量变更
git add -A

# 执行pre-commit钩子
.git/hooks/pre-commit

# 检查钩子是否修改了文件
if ! git diff --quiet; then
    # 若有修改，重新暂存变更
    git add -A
fi

# 用原始提交的元数据重新提交，保留作者、日期和提交信息
git commit --amend --no-edit --author="$(git log -1 --format='%an <%ae>')" --date="$(git log -1 --format='%ad')"

步骤3：批量执行历史重写 #

使用git rebase的--exec选项，从根提交开始批量处理所有历史提交：

git rebase -i --root --exec "./process-commit.sh"

• --root表示从仓库的第一个提交开始处理
• --exec会在每个提交上自动执行指定脚本

步骤4：处理冲突 #

若某个提交在rebase过程中出现冲突（比如钩子修改内容与历史提交冲突），Git会暂停重写流程，此时：

1. 手动解决文件冲突
2. 执行git add <冲突文件>暂存解决后的内容
3. 运行./process-commit.sh完成当前提交的钩子应用与元数据保留
4. 执行git rebase --continue继续处理下一个提交

步骤5：推送到新仓库 #

完成所有提交处理后，将重写后的分支推送到新仓库：

git remote add new-origin <新仓库URL>
git push new-origin rewrite-history --force

（注：--force是必须的，因为重写了历史记录）

替代方案：git filter-branch（适合简单场景） #

若pre-commit钩子无需与历史提交产生复杂交互，也可使用git filter-branch：

git filter-branch --tree-filter '
    git add -A
    .git/hooks/pre-commit
    if ! git diff --quiet; then
        git add -A
        git commit --amend --no-edit --author="$(git log -1 --format='%an <%ae>')" --date="$(git log -1 --format='%ad')"
    fi
' --root

但filter-branch处理大量提交时性能不如rebase，且冲突处理更繁琐，优先推荐rebase方案。

关键注意事项 #

• 重写前务必备份原始仓库，避免数据丢失
• 确保本地环境已安装pre-commit钩子依赖的外部工具（如代码格式化器、检查器）
• 历史重写后，所有基于原始历史的分支需重新同步，仅在私有仓库或团队明确知情的场景下操作

内容的提问来源于stack exchange，提问作者Dennis Golomazov