如何彻底清空 Git 提交历史并重新开始？

在长期维护的 Git 项目中，提交记录可能会变得杂乱无章，影响性能和可读性。本篇介绍四种方法彻底清空 Git 提交历史，包括删除 .git 目录、创建无历史分支、使用 git filter-repo 以及手动迁移代码。可以根据项目需求选择最合适的方式。

1. 删除 `.git` 目录并重新初始化（最干净的方法）

如果你想彻底清空所有 Git 记录并从头开始，最简单的方法就是直接删除 .git 目录并重新初始化仓库：

rm -rf .git  # 删除 Git 目录
git init     # 重新初始化 Git 仓库
git add .    # 添加所有文件
git commit -m "Initial commit"  # 创建新的提交

优点：

缺点：

如果你希望清空提交历史但仍保留 .git 目录和远程仓库，可以使用 --orphan 创建一个新的无历史分支：

1	git checkout --orphan clean-main

然后添加所有文件并提交：

1 2	git add . git commit -m "Initial commit"

删除旧的 main 分支，并将新分支重命名回 main：

1 2	git branch -D main # 删除旧的 main 分支 git branch -m main # 将 clean-main 重命名为 main

如果需要覆盖远程仓库（谨慎操作！）：

1	git push --force origin main

优点：

缺点：

如果你的项目非常大，历史提交太多，Git 官方推荐使用 git filter-repo（比 git filter-branch 更高效）：

1	git filter-repo --path . --force

然后强制推送到远程仓库：

1	git push --force --all

优点：

缺点：

如果未安装，可以使用以下命令安装（适用于 macOS）：

1	brew install git-filter-repo

如果你希望彻底摆脱所有历史记录，并创建一个全新的仓库，最干净的方法是手动复制代码：

进入新目录，初始化 Git：

1
2
3

git init
git add .
git commit -m "Initial commit"

如果有远程仓库，重新添加它：

1 2	git remote add origin <repo-url> git push -u origin main --force

优点：

缺点：

方法	适用情况	是否保留 `.git`	是否需要远程强制推送
删除 `.git` 重新初始化	彻底重置，最简单	❌ 否	✅ 需要
创建无历史新分支	只想清空提交记录	✅ 是	✅ 需要
`git filter-repo` 清理历史	处理大仓库，官方推荐	✅ 是	✅ 需要
手动复制到新仓库	最干净，适合长期维护	❌ 否	✅ 需要