Git推送忽略HEAD计算最小增量的原因及无命名引用解决办法

问题复现脚本 #

#!/usr/bin/env bash
set -euo pipefail

git -c advice.detachedHead=false clone --depth=1 -b v2.38.0 https://github.com/git/git.git dummy_git1
cp -arT dummy_git1 dummy_git2

git -C dummy_git2 tag -d v2.38.0
git -C dummy_git1 branch dummy_branch1

echo "The command below should finish immediately, but it actually slowly copies all the blobs:" 1>&2
(set -x && git -C dummy_git1 push ../dummy_git2 dummy_branch1:dummy_branch1)

rm -rf dummy_git1 dummy_git2  # clean up

问题描述 #

当git push决定要发送哪些blobs时，会考虑远程仓库的所有现有引用以实现最少数据传输，但唯独忽略分离状态的HEAD。如果远程HEAD关联到某个分支，这个问题不会出现——因为该分支会被当作增量基准；但当远程HEAD处于分离状态，且是相关提交的唯一指针时，Git不会将其纳入考量，反而会推送所有内容，仿佛远程没有任何相关blobs，即便远程实际已拥有全部blobs。本质上，Git计算增量时是从引用（refs）而非提交（commits）入手，导致必要blobs已存在于远程时仍产生不必要的大量慢传输。

具体问题 #

• 为何会出现这种情况？
• 有无无需在远程创建命名引用的解决办法？

回答 #

1. 问题原因 #

Git在计算推送增量时，默认只会扫描远程仓库的命名引用（比如分支、标签这类有明确名称的refs），分离状态的HEAD本质上只是一个指向提交的特殊临时指针，不属于命名引用范畴，因此不会被纳入增量基准的考量范围。这是Git设计上的取舍：命名引用是仓库中稳定、显式的指针，而分离HEAD通常是临时状态（比如CI环境的临时 checkout、查看历史提交），Git默认不会依赖这种易变的临时状态来优化传输，避免因HEAD频繁变动导致增量计算出错。

2. 无需创建远程命名引用的解决办法 #

可以通过以下两种方式解决，无需在远程创建新的命名引用：

• 方法一：指定远程HEAD提交作为推送基准
  先获取远程分离HEAD对应的提交哈希，再在推送时以该哈希为基准，只传输差异内容：

  # 获取远程HEAD的提交哈希
  REMOTE_HEAD_HASH=$(git -C dummy_git2 rev-parse HEAD)
  # 推送时以该哈希为基准，避免重复传输
  git -C dummy_git1 push --force-with-lease=HEAD:$REMOTE_HEAD_HASH ../dummy_git2 dummy_branch1:dummy_branch1
  

• 方法二：使用--reference-if-able参数
  Git 2.11及以上版本支持--reference-if-able参数，它会自动检测远程仓库中已有的提交（包括分离HEAD指向的提交），以此作为基准优化传输：

  git -C dummy_git1 push --reference-if-able ../dummy_git2 dummy_branch1:dummy_branch1
  

  该参数会识别本地与远程的共同祖先提交，直接跳过已存在的blobs传输，大幅提升速度。

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