前言
最近在管理git仓库提交的时候，发现自己开始变得洁癖了，原来的开发流程是从主分支分支创建一个feature分支，然后feature分支开发完成后，压缩合并到主分支，这样不管 feature 分支有多少次提交，合并到主分支后，都会变成一条提交。
习惯了这种方式后，最近在新仓库做项目基础搭建的时候，因为是直接在main分支上提交的，加上nuxt4这个框架没什么可参考的模板，大部分时间都是自己在摸索，导致产生了很多提交记录，等基建完成后，就想着能不能把这些提交记录合并成一条提交，这样就不会显得太乱了。
于是就有了这篇文章，记录一下如何将所有历史提交合并成一条提交。
警告：安全第一
修改 Git 历史属于高风险操作。在开始之前，请务必确认：
- 这是你个人独立开发的项目，或者：
- 你的团队成员已经知晓此操作。因为历史重写后，所有协作者的本地仓库都需要手动同步，否则会导致严重的冲突。
将所有历史提交合并为一条
要把一个项目自创建以来的所有提交合并为一条，最彻底、最干净的方法是使用 “孤儿分支（Orphan Branch）” 法。
步骤 1：创建并切换到一个全新的“孤儿”分支
这个分支的特点是：没有任何历史提交记录，但保留你当前所有的代码文件。
git checkout --orphan temp_main步骤 2：将所有文件添加到暂存区
git add -A步骤 3：提交代码，作为全新的第一次提交
git commit -m "init"此时，你的代码库在 temp_main 分支上只有一条名为 "init" 的提交记录了。
步骤 4：删除旧的本地 main 分支
我们需要把旧的、带有杂乱历史的分支删掉：
git branch -D main步骤 5：将当前分支重命名为 main
git branch -m main至此，你本地的 main 分支已经重塑成功，历史记录只剩下一条 "init"。
步骤 6：强推到远程仓库
因为你改变了历史，直接推送会被拒绝，必须使用强制推送（Force Push）：
git push -f origin main解决“推送完无法拉取”的问题
在强推成功后，你或者你的同事如果直接运行 git pull，大概率会遇到类似下面的报错：
fatal: refusing to merge unrelated histories
# 或者提示：Your branch and 'origin/main' have diverged...为什么会这样？
因为 Git 是基于 Commit Hash（提交哈希值） 来比对历史的。
虽然远程仓库和本地仓库的代码内容一模一样，但由于你重写了历史，远程的 "init" 提交是一个全新的哈希值，而你（或同事）本地还保留着旧的提交链。Git 认为这是两个完全不同的项目，因此出于安全保护，拒绝了自动合并。
正确的解决方案
既然远程的 main 已经是你想要的最终状态（只有一个 init 提交），你只需要强行让本地与远程保持一致，抛弃本地旧的历史。
在本地终端依次运行以下两条命令：
# 1. 获取远程最新的提交数据（不进行合并）
git fetch origin
# 2. 将本地分支强制重置为远程分支的状态
git reset --hard origin/main命令解析：
git fetch origin：告诉本地 Git 去看一眼远程仓库现在长什么样。git reset --hard origin/main：这是灵魂一步。--hard会丢弃本地所有未提交的修改和旧的历史，强行将本地指针对齐远程的main。
执行完毕后，本地和远程彻底同步，后续的 git pull 和 git push 即可恢复正常工作！