如何将Git仓库初始的1000个提交合并为单个提交？

前置准备 #

• 备份仓库：复制本地仓库文件夹到安全位置，或用git clone --mirror <远程仓库地址> backup-repo.git创建镜像备份，避免操作失误丢失数据。
• 暂停所有设备的cron任务：确保所有设备已将本地更改推送到远程，且无未提交内容，临时关闭每台设备上的5分钟自动拉推任务，防止冲突。
• 确认提交数量：用git rev-list --count HEAD查看总提交数，确保确实有超过1000个提交需要处理。

步骤1：定位目标提交 #

找到第1001个提交（即前1000个提交之后的第一个提交）的哈希值，执行命令：

# 获取总提交数
TOTAL_COMMITS=$(git rev-list --count HEAD)
# 计算并获取第1001个提交的哈希
TARGET_COMMIT=$(git log --oneline | tail -n +1001 | head -1 | awk '{print $1}')

步骤2：交互式变基合并早期提交 #

执行变基命令，将前1000个提交合并为一个：

git rebase -i --root ${TARGET_COMMIT}~1

命令执行后会打开文本编辑器，里面列出从初始提交到第1000个提交的所有记录：

• 保留第一个提交的pick指令；
• 将后续999个提交的pick全部改为squash（保留原提交信息）或fixup（丢弃原提交信息，仅保留内容）；
• 保存退出后，Git会自动合并这些提交，此时可编辑新的提交信息（比如写“合并早期1000个提交：个人笔记初始累积内容”）。

步骤3：强制推送修改到远程 #

由于修改了Git历史，需要强制推送覆盖远程仓库：

git push -f origin main  # 替换main为你的实际主分支名，如master

步骤4：同步所有设备 #

在每台设备上执行以下操作同步修改（确保本地无未提交内容）：

git fetch origin
git reset --hard origin/main  # 此命令会覆盖本地未推送的更改，操作前确认本地干净
# 或使用rebase拉取：git pull --rebase origin main

步骤5：恢复cron任务与清理仓库 #

• 所有设备同步完成后，重新开启每台设备的5分钟cron自动拉推任务；
• 执行以下命令清理仓库冗余对象，进一步减小体积：

  git gc --prune=now --aggressive
  

  若为自建Git服务器，需在服务器端也执行此命令；若为托管平台（如GitHub），平台会自动后台清理旧对象。

注意事项 #

• 此操作修改了Git历史，仅适用于个人仓库，若有协作者需提前沟通；
• 全程确保所有设备本地无未提交、未推送的更改，否则会导致数据丢失；
• 若操作中出现问题，可通过之前的备份仓库恢复。

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