Git配置中fetch行为何影响git branch --set-upstream-to的行为？

问题重现 #

适用于已配置origin远程仓库且存在main分支的任意Git仓库：

正常配置下的执行结果 #

执行命令：

git branch --set-upstream-to=origin/main main

输出：

Branch 'main' set up to track remote branch 'main' from 'origin'.

此时.git/config中对应分支配置为：

[branch "main"]
    remote = origin
    merge = refs/heads/main

修改Fetch规则后的异常结果 #

编辑.git/config中的origin远程配置：

[remote "origin"]
    url = /tmp/test/p0-bkup
# 原配置：
#    fetch = +refs/heads/*:refs/remotes/origin/*
# 替换为：
    fetch = +refs/*:refs/*

再次执行相同命令：

git branch --set-upstream-to=origin/main main

输出变为：

Branch 'main' set up to track remote ref 'refs/remotes/origin/main'.

此时.git/config中的分支配置变为：

[branch "main"]
    remote = origin
    merge = refs/remotes/origin/main

说明：fetch = +refs/*:refs/*这类配置常见于git clone --mirror操作后的仓库。

核心疑问与解答 #

1. 为何Fetch规则会影响git branch --set-upstream-to的行为？ #

Git的fetch规则并非仅控制拉取操作，它还定义了远程引用到本地引用的映射关系。当你使用origin/main这种简写时，Git需要通过fetch配置来解析这个简写对应的实际引用路径：

• 正常配置fetch = +refs/heads/*:refs/remotes/origin/*中，refs/heads/*（远程分支）会被映射到本地refs/remotes/origin/*，所以origin/main会被解析为远程的refs/heads/main，因此merge字段会设置为refs/heads/main。
• 当使用镜像仓库的fetch = +refs/*:refs/*时，所有远程引用（包括refs/remotes/下的引用）会直接映射到本地同名路径，此时origin/main会被解析为本地已存在的refs/remotes/origin/main（因为镜像拉取了远程的所有引用），所以Git会将merge字段设置为这个本地映射后的引用路径。

2. Fetch规则是如何处理并产生两种不同结果的？ #

Git在解析remote/branch形式的引用时，会遵循以下逻辑：

1. 首先检查本地是否存在refs/remotes/remote/branch引用；
2. 若存在，再通过fetch配置的映射规则反向推导对应的远程引用：
   • 对于普通fetch规则，refs/remotes/origin/main对应的远程引用是refs/heads/main（通过替换映射规则：refs/remotes/origin/* ← refs/heads/*）；
   • 对于镜像fetch规则，refs/remotes/origin/main对应的远程引用就是自身（因为映射是refs/*:refs/*，双向等价）；
3. 最终根据推导结果设置merge字段：普通配置下指向远程的分支引用，镜像配置下指向本地映射后的远程跟踪引用。

3. 镜像仓库这种行为的适用场景？ #

git clone --mirror创建的镜像仓库主要用于以下场景：

• 仓库备份：完整复制远程仓库的所有引用（包括分支、标签、远程跟踪分支等），确保数据完整；
• 仓库迁移：需要将整个仓库（含所有历史和引用）转移到新的托管平台时，镜像拉取能保证所有引用被完整迁移；
• 只读镜像服务：在内部网络搭建远程仓库的只读镜像，减少外部网络依赖，提升拉取速度；
• CI/CD缓存节点：作为共享缓存，存储完整的仓库引用，避免重复拉取大仓库的所有数据。

测试脚本 #

以下是用于验证问题的完整测试脚本，会在/tmp目录创建测试仓库并自动执行验证步骤：

#!/bin/bash

test_dir=/tmp/test
if [ -d $test_dir ] ; then rm --recursive --dir --force $test_dir/* ; else mkdir $test_dir; fi
file_name=text.txt
cd $test_dir

edit_file_and_commit(){
    echo "$1" | tee --append $file_name
    git add $file_name
    git commit -m "$1"
}

print_and_run(){
    echo next line: "$1"
    $1 # echo "$($1)"
}

print_and_run_2() {
    printf "next line:"
    printf " '%s'" "$@"
    printf "\n"
    echo "$($@)"
}

pause(){ echo; echo pause, type exit to end the pause; bash; }

echo;echo now in p0
mkdir p0 && cd $_
git init
touch $file_name
edit_file_and_commit "commit main-1 in p0"
git branch --move main # rename in case default is master
git checkout -b devel
edit_file_and_commit "commit devel-1 in p0"
git checkout main
edit_file_and_commit "commit main-2 in p0"

touch text2
git add text2
git commit -m "text2"
git checkout devel

echo;echo now in p1
cd $test_dir
mkdir p1 && cd $_
git clone $test_dir/p0 .

mv $test_dir/p0 $test_dir/p0-bkup

git branch -a
git checkout main
git branch -a
ls -al

git remote set-url origin $test_dir/p0-bkup
git push
echo next git remote -v 
git remote -v
echo next ls -la $test_dir/p1/.git/refs/remotes/origin
ls -la $test_dir/p1/.git/refs/remotes/origin
echo I see HEAD only, AFAIK not as in fully set repo
git branch -vv

git checkout main
edit_file_and_commit "commit main-1 in p1"
git checkout -b qa

echo;echo now in p2
cd $test_dir
mkdir p2 && cd $_
git clone --mirror $test_dir/p1 ./.git
git config core.bare false
git status
git checkout main
git status
edit_file_and_commit "commit main-1 in p2"

print_and_run 'cat ./.git/config'
print_and_run 'git branch --set-upstream-to=origin/main main'
print_and_run 'cat ./.git/config'
print_and_run_2 sed --in-place -- "s|fetch = +refs/\*:refs/\*|fetch = +refs/heads/*:refs/remotes/origin/*|" .git/config
set -x # Print shell input lines as they are read.
cat ./.git/config
git branch --set-upstream-to=origin/main main
cat ./.git/config

set +x 

exit

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