Git浅克隆：如何移除‘grafted标签’？模板项目迁移操作疑问

嘿，我来帮你搞定这两个Git问题，都是浅克隆相关的常见坑，咱们一步步来：

「grafted」标签的含义 #

当你用--depth=1做浅克隆时，Git只会拉取仓库最新的那一个提交——这个提交在本地没有对应的父提交（因为完整历史没拉下来），Git就给它打上grafted标记。说白了就是这个提交是“嫁接”在你的本地仓库里的，没有完整的历史链条，是个“无根”的特殊提交。

移除「grafted」标签的方法 #

要去掉这个标记，核心是把完整的仓库历史拉到本地，把浅克隆转成完整克隆就行：

git fetch --unshallow

如果你用的Git版本特别旧（不过你用的2.14.1完全支持这个命令），万一这个命令不好使，就换下面两句：

git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
git fetch origin

等所有历史都拉取完成后，那个grafted标记就会自动消失——因为现在这个提交的父提交已经在本地仓库里了，历史链条完整了。

看你的操作流程，已经把模板克隆下来、替换了远程仓库，接下来应该是要把模板内容推到新项目的远程仓库对吧？这里要注意：你的目标远程projectA.git已经有一个带.gitignore的空提交了，而本地是浅克隆的模板提交，两者是完全无关的历史，所以分两种情况处理：

情况1：直接覆盖远程的空提交（推荐，因为远程只是初始提交） #

如果你确定没人在这个远程仓库干活，而且就是想用模板完全替代那个空提交，直接强制推送就行：

# 分支是master的话用这个
git push -f origin master
# 分支是主流main的话换成
git push -f origin main

强制推送会把远程的历史完全替换成本地的，这样新项目的远程就和模板内容一致，历史也更干净。

情况2：保留远程初始提交，合并模板内容 #

如果不想覆盖历史，要把模板内容合并到那个空提交上，先拉取远程内容——因为两个历史完全无关，必须加--allow-unrelated-histories参数：

git pull origin master --allow-unrelated-histories

之后可能会遇到冲突（比如.gitignore文件的冲突），手动解决冲突后提交，再正常推送：

git push origin master

这种方式会保留两个提交的历史，适合需要追溯初始提交的场景。

另外，你克隆时用了--recursive拉取子模块，推送主项目后，子模块的引用会被同步上去，但如果子模块本身需要更新远程，记得单独进入子模块目录处理哦。

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