Git fetch配置未包含分支时，如何建立本地与远程分支的追踪？

问题背景 #

在大型单体仓库中，Git默认fetch配置被限制为仅拉取master分支：

fetch = +refs/heads/master:refs/remotes/origin/master

拉取他人分支时，执行git fetch origin <branch-name>:<branch-name>虽能创建本地分支和对应的远程引用，但无法建立两者的追踪关系。尝试用git branch -u origin/<branch-name>手动设置时会报错：

fatal: cannot set up tracking information; starting point 'origin/<branch-name>' is not a branch

即便git branch -r --list能看到该远程引用、git show可正常操作，追踪设置仍失败。

无需修改fetch配置的解决方案 #

方法1：拉取时直接建立追踪关系 #

跳过先fetch再手动设置的步骤，用以下命令一次性完成拉取与追踪关联：

git fetch origin refs/heads/<branch-name>:refs/remotes/origin/<branch-name> && git checkout --track origin/<branch-name>

• 第一部分命令明确将远程分支拉取为标准的远程追踪分支（origin/<branch-name>）
• 第二部分命令基于该远程追踪分支创建本地分支，并自动建立追踪关系

方法2：手动编辑Git配置文件 #

若已通过git fetch origin <branch-name>:<branch-name>创建了本地分支，可直接编辑仓库根目录下的.git/config文件，找到对应本地分支的配置块，添加追踪规则：

[branch "<branch-name>"]
    remote = origin
    merge = refs/heads/<branch-name>

保存后，本地分支与origin/<branch-name>的追踪关系即建立，后续可正常使用git pull拉取更新。

方法3：用git config命令手动配置追踪参数 #

通过命令行直接设置本地分支的远程关联与合并路径，效果与编辑配置文件一致：

git config branch.<branch-name>.remote origin
git config branch.<branch-name>.merge refs/heads/<branch-name>

错误原因说明 #

Git要求用于设置追踪的远程分支必须是符合默认fetch规则同步的规范分支，而你通过git fetch origin <branch-name>:<branch-name>创建的origin/<branch-name>属于"临时引用"，不在Git默认的fetch引用范围内，因此git branch -u会判定其不是合法的追踪起点。上述方法均通过手动建立关联的方式绕过了这个限制。

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