如何阻止Git在fetch时自动关联并展开相关历史？

问题描述 #

我用Git搭建模板系统时遇到了自动解除浅克隆（unshallowing）的问题，具体情况如下：

• 背景：流程是把template仓库复制为new_repo并丢弃所有历史，后续两者各自提交后，new_repo需要拉取template的变更做对比。
• 当前实现：用git clone --depth 1创建仅含最新提交的new_repo，随后移除template远程仓库。一段时间后执行git fetch获取template历史时，Git意外解除了new_repo的浅克隆，而非仅拉取template的提交。
• 疑问：想知道这种历史残留关联的机制，以及如何阻止Git展开new_repo的历史。

可复现步骤 #

$ git clone file://home/test/template --depth 1 new_repo
[...]
$ ls
new_repo/
template/
$ cd new_repo
$ git log main
commit ac787e… (grafted, HEAD -> main, origin/main, origin/HEAD)
Date:   Sun Jun 1 16:27:29 2025 -0700

    transient technology
$ git remote remove origin
$ git fetch ../template --shallow-since="2025-06-01 16:00:00 -0700"
[...]
$ git log main
commit ac787e… (HEAD -> main)
Date:   Sun Jun 1 16:27:29 2025 -0700

    transient technology

===== Result of git unshallowing history from template ===
|  commit 744f4f…
|  Date:   Sun Jun 1 16:27:29 2025 -0700
|
|      initial commit
======

原因分析：Git浅克隆的残留关联机制 #

当你用--depth 1克隆template仓库时，new_repo里的提交处于**嫁接（grafted）**状态——Git会在本地记录这个提交的父提交信息（即使本地没有这些父提交的对象）。后续fetch同一个仓库的完整历史时，Git通过提交的唯一哈希值识别出new_repo的嫁接提交和template仓库的提交是同一个对象，进而自动补全该提交的所有父历史，导致new_repo的浅克隆被解除。

简言之，Git靠提交哈希判断历史关联，哪怕你移除了origin远程，只要目标仓库包含当前本地提交的父历史，就会触发自动补全。

解决方法：切断历史关联，阻止自动unshallow #

方法1：创建全新无历史仓库（彻底切断关联） #

放弃浅克隆，直接新建空仓库并复制template文件：

# 新建空仓库
mkdir new_repo && cd new_repo
git init
# 复制template所有文件（忽略.git目录）
cp -r ../template/* .
# 提交初始版本
git add .
git commit -m "initial template import"

这种方式下new_repo的初始提交哈希和template完全不同，后续fetch template时不会有任何历史关联，自然不会触发unshallow。

方法2：修改嫁接提交，移除父历史关联 #

如果必须基于浅克隆仓库修改，可用git replace修改嫁接提交，移除其父提交记录：

cd new_repo
# 获取当前main分支的提交哈希
commit_hash=$(git rev-parse main)
# 创建无父提交的新版本，替换原嫁接提交
git replace --graft $commit_hash
# 可选：永久化替换（避免后续操作失效）
git filter-repo --force

执行后原嫁接提交会变成独立的根提交，再fetch template时，Git无法识别两者的历史关联，不会自动补全new_repo的历史。

方法3：fetch时强制禁止解除浅克隆 #

如果不想修改仓库结构，可在fetch时添加--no-unshallow参数：

git fetch ../template --shallow-since="2025-06-01 16:00:00 -0700" --no-unshallow

注意：此方法有局限性，若template和new_repo的提交存在历史交集，Git仍可能尝试补全部分历史，不如前两种方法彻底。

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