检出远程分支时自动给本地分支添加远程名前缀

一、Git原生配置/脚本实现 #

自定义Git别名快速创建带前缀分支 #

直接在全局Git配置里加个别名，就能一键创建带远程前缀的本地分支：

git config --global alias.co-prefix '!f() { git checkout -b "$1/$2" "$1/$2"; }; f'

使用时执行：

git co-prefix origin-a dev

这行命令会直接创建并检出origin-a/dev分支，完美避开和已有dev分支的冲突。

用钩子自动重命名新分支 #

如果不想每次敲别名，可以给项目加个post-checkout钩子，自动把新检出的同名本地分支改成远程名/分支名格式：

1. 进入项目的.git/hooks目录，新建post-checkout文件
2. 粘贴以下脚本，然后给文件添加执行权限（chmod +x post-checkout）

#!/bin/sh
OLD_REV="$1"
NEW_REV="$2"
CHECKOUT_TYPE="$3"

# 仅处理新建本地分支的情况
if [ "$CHECKOUT_TYPE" = "1" ]; then
    CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
    REMOTE_BRANCH=$(git for-each-ref --format='%(upstream:short)' "$(git symbolic-ref -q HEAD)")
    
    if [ -n "$REMOTE_BRANCH" ]; then
        REMOTE_NAME=$(echo "$REMOTE_BRANCH" | cut -d'/' -f1)
        REMOTE_BRANCH_NAME=$(echo "$REMOTE_BRANCH" | cut -d'/' -f2-)
        
        # 如果本地分支名和远程分支名一致，且不是前缀格式，自动重命名
        if [ "$CURRENT_BRANCH" = "$REMOTE_BRANCH_NAME" ] && [[ ! "$CURRENT_BRANCH" == */* ]]; then
            git branch -m "$REMOTE_NAME/$REMOTE_BRANCH_NAME"
            echo "自动重命名分支为: $REMOTE_NAME/$REMOTE_BRANCH_NAME"
        fi
    fi
fi

之后检出任何远程分支时，只要本地没有同名前缀分支，就会自动改成带远程名的格式。

二、VSCode环境下的优化 #

内置SCM的手动操作 #

VSCode自带的SCM面板里，右键点击远程分支，选择「创建分支...」，手动输入origin-a/dev这类带前缀的名称即可，操作简单直接。

用扩展实现自动填充 #

• GitLens: 这款扩展支持自定义分支检出的命名模板。打开设置，搜索gitlens.branch.checkoutAsTemplate，将值设置为${remoteName}/${branchName}。之后右键远程分支选「Checkout as...」，输入框会自动填充带远程前缀的分支名，直接确认即可。
• Git Graph: 可视化分支工具，右键远程分支选「Create Local Branch From...」，可设置默认命名规则，或直接输入前缀格式的名称，界面更直观。

三、替代方案：用Git Worktree隔离分支 #

如果不想修改分支名，还可以用git worktree把不同远程的分支分到不同目录，完全避免冲突：

git worktree add ../project-origin-a origin-a/dev

这条命令会在../project-origin-a目录下检出origin-a/dev分支，和主项目目录的分支互不影响，适合长期维护多个远程分支的场景。

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