浅克隆仓库后执行git push --mirror报错如何解决？

问题根源 #

你用git clone --depth 100做的是浅克隆，本地仓库只保留了最近100次提交的历史，缺少完整的分支、标签以及更早的提交记录。而git push --mirror的作用是推送本地所有引用（分支、标签、远程跟踪分支等）到目标仓库，一旦本地引用对应的历史不完整，或者目标仓库已有冲突的引用，就会触发error: failed to push some refs to报错。

具体解决方案 #

根据你的需求选对应的方法：

1. 只推送当前分支的最近历史（不需要镜像所有内容）

如果不需要同步所有分支/标签，只推当前工作分支：

• 先添加新的远程仓库：

  git remote add new-origin <你的新目标仓库URL>
  

• 推送当前分支到新仓库：

  git push new-origin <你的分支名>
  

• 要是以后想直接用git push推送，设置上游分支：

  git push -u new-origin <你的分支名>
  

2. 必须镜像所有分支/标签（需要补全仓库历史）

浅克隆的本地仓库缺少完整数据，没法直接镜像推送，得先补全历史：

• 尝试补全为完整仓库：

  git fetch --unshallow
  

• 如果上面的命令失败（比如原仓库设置了限制），用最大深度拉取完整历史：

  git fetch --depth=2147483647
  

• 补全后再执行镜像推送：

  git push --mirror <你的新目标仓库URL>
  

3. 目标仓库已有内容，需要强制覆盖（谨慎使用）

如果目标仓库已经存在相同分支/标签，且你确认要覆盖它的内容：

• 强制镜像推送：

  git push --mirror --force <你的新目标仓库URL>
  

• 或者针对单个分支强制推送：

  git push new-origin <你的分支名> --force
  

注意：强制推送会直接覆盖目标仓库的对应内容，操作前一定要确认不会丢失重要数据。

额外提醒 #

浅克隆只适合快速拉取代码做临时开发，不适合用来做仓库镜像同步——镜像同步需要完整的仓库历史和所有引用，否则很容易出现推送失败的情况。如果仓库体积过大，补全历史可能需要较长时间，建议在网络稳定的环境下操作。

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