如何基于指定ref获取仅包含必要历史的Git分支？

问题背景 #

我们维护着存在多年的Git基础分支，包含数万条历史提交，累计产生过数十GB的历史数据。当前在GitHub Actions中运行的工作流，会在基础分支变更时自动变基指定开放PR的特性分支，但随着分支体量增长，工作流耗时持续增加——核心原因是每次都要下载并重放大量不必要的历史提交。

尝试过常规浅拉取，但仅拉取最新提交无法满足变基的历史依赖需求；设置固定拉取深度也不可行，因为特性分支的生命周期长短不一，固定深度可能导致历史缺失。我们的目标是：拉取base分支和feature-1至feature-N分支中刚好足够支撑变基的历史切片。

目前已实现并推送了nca分支，其尖端指向base与所有目标特性分支的最近公共祖先（NCA），且能通过git ls-remote快速获取该分支的提交哈希。现在需要确认：能否利用这个NCA ref实现类似git fetch --shallow-since=[date]、但基于提交引用的精准浅拉取？

解决方案 #

完全可以借助NCA的提交哈希实现精准的浅拉取，只获取从公共祖先到各分支尖端的必要历史，具体操作步骤如下：

1. 获取NCA的提交哈希 #

先通过git ls-remote快速拉取nca分支的尖端哈希，无需克隆完整仓库：

NCA_HASH=$(git ls-remote origin nca | cut -f1)

2. 拉取目标分支的必要历史 #

使用Git的--shallow-exclude参数，排除NCA之前的所有历史，只拉取NCA之后的提交链。同时加上--no-tags避免拉取无关标签，进一步提速：

# 拉取base分支的必要历史
git fetch origin base --shallow-exclude=$NCA_HASH --no-tags

# 拉取单个特性分支的必要历史
git fetch origin feature-1 --shallow-exclude=$NCA_HASH --no-tags

# 批量拉取多个特性分支
for branch in feature-1 feature-2 feature-N; do
  git fetch origin $branch --shallow-exclude=$NCA_HASH --no-tags
done

3. 验证本地历史完整性 #

拉取完成后，可通过以下命令确认本地仅保留了NCA之后的提交：

# 查看base分支从NCA到尖端的提交
git log --oneline $NCA_HASH..base

# 查看feature-1分支从NCA到尖端的提交
git log --oneline $NCA_HASH..feature-1

这些命令应列出对应分支从NCA到当前尖端的所有提交，且不会显示更早的历史。

4. 执行变基操作 #

此时本地已具备变基所需的完整历史上下文，可正常执行变基：

git checkout feature-1
git rebase base

原理说明 #

--shallow-exclude=<ref>参数的作用是告诉Git：不要拉取指定ref之前的任何历史，仅保留该ref之后的提交链。这完美匹配我们的需求——只获取所有目标分支的公共起点（NCA）到各分支尖端的历史，既不会缺失变基所需的依赖上下文，又能最大限度减少下载的数据量，大幅缩短工作流的运行时间。

需要注意的是：如果NCA之后存在合并提交，Git会自动处理合并所需的关联历史，确保变基操作能正常完成，无需额外配置。

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