如何使用本地历史与文件完全覆盖远程Git分支并清空原有内容及提交记录

前置说明 #

本方案可以实现完全清空远程仓库所有提交历史、原有文件，用本地内容100%覆盖，不会残留任何旧数据，解决普通git push --force仍残留旧文件的问题。
操作前请提前备份远程仓库原有内容，确认本地待上传的项目内容为最终版本，操作后原有历史和文件无法恢复

操作步骤 #

第一步：处理本地项目，生成无历史的孤立提交 #

• 进入本地现有项目的根目录，执行以下命令创建无任何历史记录的孤立分支：

git checkout --orphan temp_branch

• 暂存本地所有项目文件：

git add -A

• 提交当前所有内容，生成唯一的初始提交：

git commit -m "init: 全新项目初始化"

第二步：关联远程Azure仓库并强制覆盖 #

• 如果本地之前已经关联过该Azure远程仓库，先删除旧的远程关联：

git remote remove origin

• 绑定你的Azure远程仓库地址：

git remote add origin <替换为你的Azure远程仓库HTTPS/SSH地址>

• 强制将本地孤立分支推送到远程主分支（远程主分支默认一般为main，如果是旧版仓库请替换为master），直接覆盖远程分支的所有历史和内容：

git push -f origin temp_branch:main

第三步：本地分支收尾处理 #

• 删除本地原来的主分支：

git branch -D main

• 将当前临时孤立分支重命名为main，保持和远程分支对齐：

git branch -m main

• 绑定本地main分支和远程main分支的关联关系：

git branch --set-upstream-to=origin/main main

更暴力的备选方案 #

如果上述操作仍有异常，可以直接在Azure仓库后台操作：

1. 临时创建一个空白分支作为远程仓库的默认分支
2. 删除原来的主分支
3. 本地正常git init提交内容后直接推送到远程的main分支，再将默认分支改回main即可

原理解释 #

普通git push --force之所以会残留旧文件，是因为你的本地分支和远程分支存在共同的历史祖先节点，强制推送只会覆盖共同节点之后的提交差异。而孤立分支和远程分支没有任何共同祖先，强制推送会直接替换远程分支的整个提交链，原有内容和历史会被完全清空，不会残留任何文件。

内容的提问来源于stack exchange，提问作者i.brod