git merge-base HEAD与远程分支无返回结果的原因及解决

核心原因 #

你遇到的git merge-base无返回结果的问题，本质是浅克隆截断了提交历史导致的：

• 你用depth="1"克隆test-branch，本地只保留了该分支的最新1个提交，没有任何历史提交记录。
• 后续fetch origin dev默认也只拉取了dev分支的最新提交，两个分支的本地提交链没有任何共同祖先，git merge-base自然找不到符合条件的基础提交，因此无输出。

解决方案 #

方案1：放弃浅克隆，完整克隆仓库 #

直接去掉克隆命令中的depth="1"参数，拉取完整的仓库历史，这样两个分支的完整提交链都会被保留，git merge-base就能正常找到共同祖先：

git-init \
  -url="${PARAM_URL}" \
  -revision="test-branch" \
  -path="${CHECKOUT_DIR}";
cd "${CHECKOUT_DIR}";
git fetch origin dev:refs/remotes/origin/dev;
git switch test-branch;
git merge-base HEAD remotes/origin/dev;

方案2：将浅克隆转换为全克隆 #

如果必须使用浅克隆初始化仓库，可以通过以下命令补全历史，再执行后续操作：

cd "${CHECKOUT_DIR}";
# 补全当前分支的完整历史
git fetch --unshallow origin;
# 拉取dev分支的完整历史
git fetch origin dev;
git switch test-branch;
git merge-base HEAD remotes/origin/dev;

方案3：直接对比分支顶端（无需找共同祖先） #

如果你的需求只是获取两个分支的差异文件列表，不需要基于共同祖先的对比，可以跳过git merge-base，直接对比两个分支的最新提交：

git diff --name-only test-branch remotes/origin/dev

注意：这个命令展示的是两个分支顶端提交的直接差异，和基于共同祖先的差异逻辑不同，需根据实际需求选择。

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