如何将Git仓库指定提交设为根提交并清除此前历史？

这种情况太常见了——当初的实验性历史变得完全无关紧要，现在只想砍掉前面的冗余部分，只保留真正有意义的提交链。下面是安全且高效的操作步骤：

步骤1：定位关键提交 #

首先找到那个「删除所有文件并粘贴新项目」的提交哈希值。运行以下命令查看简洁的提交历史：

git log --oneline

你会看到类似这样的输出：

d4e5f6 新增用户管理功能
a1b2c3 重构API接口
xyz789 【关键提交】替换为新项目基础文件  # 就是这个！
... （前面一堆无关的历史）

把这个关键提交的哈希记下来，比如xyz789。

步骤2：创建新的根分支（无历史） #

我们需要创建一个完全没有过往历史的新分支，把关键提交的内容作为它的初始提交：

# 先切换到关键提交的快照
git checkout xyz789

# 创建一个孤儿分支（完全无历史记录）
git checkout --orphan clean-history

# 提交当前内容作为新的初始提交，你可以自定义提交信息
git commit -m "Initial commit: 基于正确项目的基础设置"

步骤3：迁移后续提交到新分支 #

现在把原来分支中关键提交之后的所有提交，迁移到这个干净的新分支上。假设你原来的工作分支是main：

# 切换回原来的工作分支
git checkout main

# 使用rebase将后续提交迁移到clean-history分支末尾
git rebase --onto clean-history xyz789

这个命令的逻辑是：把main分支中从xyz789之后的所有提交，重新「嫁接」到clean-history分支的后面。

步骤4：验证并收尾 #

现在main分支的历史已经是从新的初始提交开始的了，你可以再次运行git log --oneline确认历史是否符合预期。没问题的话，就可以删除临时分支：

git branch -D clean-history

重要注意事项 #

• 先备份仓库：操作前务必复制整个Git仓库文件夹，防止操作失误丢失数据。
• 远程仓库处理：如果这个仓库已经推送到远程平台（比如GitHub/GitLab），你需要强制推送重写后的分支：

  git push -f origin main
  

  但要特别注意：强制推送会覆盖远程的历史记录，必须提前告知所有协作的开发者，让他们重新拉取并处理本地分支的冲突（通常他们需要执行git pull --rebase origin main，或者直接重新克隆仓库）。
• 彻底清理旧历史：如果想要完全清除本地仓库中被砍掉的旧历史，可以运行git gc --prune=now来清理无用的Git对象，这一步可选，只要你不再需要旧历史就可以执行。

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