Shell脚本批量重命名Git分支添加feature/前缀异常排查

• 远程分支拉取逻辑错误：原脚本循环checkout远程分支时未创建本地跟踪分支，会进入分离头指针状态，实际没有将所有远程分支同步到本地，后续重命名覆盖范围不全。
• 重命名逻辑顺序错误：原脚本先加feature/前缀，再执行特殊字符替换，且每次循环都全量扫描所有分支做替换，会重复处理已经修改完成的分支；加上git branch输出的当前分支前带*标记，未做清洗就传给awk/xargs解析，遇到带斜杠的层级分支名（比如feature/xxx）时会错误拆分参数，触发重命名冲突，这就是用feature/前缀时执行异常的核心原因。
• 字符替换逻辑不全：原脚本用awk的sub()方法仅替换第一个匹配的下划线/点，分支名存在多个特殊字符时无法全部替换，且完全没有实现大写转小写的逻辑。
• 分支排除规则不完善：原脚本仅匹配完全等于核心分支名的分支，重命名后生成的feature/开头分支不会被排除，会被重复纳入重命名循环，导致逻辑混乱。

前置准备 #

先进入本地仓库目录，确保工作区没有未提交的变更，避免分支切换/重命名过程中出现冲突。

完整重命名脚本 #

脚本优先处理本地分支，所有操作可回溯，确认结果正确后再同步到远程：

#!/bin/bash
set -eu

# 同步所有远程分支最新状态，清理失效远程引用
git fetch --all -p

# 拉取所有远程分支为本地跟踪分支，已存在的本地分支跳过
for remote_ref in $(git for-each-ref --format='%(refname:short)' refs/remotes/origin | grep -v HEAD); do
    branch_name=${remote_ref#origin/}
    if ! git show-ref --verify --quiet "refs/heads/$branch_name"; then
        git branch --track "$branch_name" "$remote_ref"
    fi
done

# 备份重命名前的分支列表，用于后续清理远程旧分支
git for-each-ref --format='%(refname:short)' refs/heads > old_branch_backup.txt

echo "===== 开始执行分支重命名 ====="
# 遍历所有本地分支处理
for old_name in $(git for-each-ref --format='%(refname:short)' refs/heads); do
    # 跳过核心分支：master/develop主分支，以及bugfix/hotfix/release/feature前缀的现有分支
    if [[ "$old_name" =~ ^(master|develop)$ ]] || [[ "$old_name" =~ ^(bugfix|hotfix|release|feature)/ ]]; then
        echo "跳过核心分支: $old_name"
        continue
    fi

    # 标准化分支名：大写转小写，下划线、点全局替换为连字符
    standard_name=$(echo "$old_name" | tr '[:upper:]' '[:lower:]' | tr '_.' '--')
    new_name="feature/$standard_name"

    if [ "$old_name" = "$new_name" ]; then
        echo "分支名无需修改: $old_name"
        continue
    fi

    echo "重命名: $old_name -> $new_name"
    git branch -m "$old_name" "$new_name"
done

echo -e "\n===== 本地分支重命名完成，当前分支列表 ====="
git branch

同步结果到远程 #

本地执行完脚本后，逐一核对分支名是否符合规则，确认无误后执行以下命令同步到GitHub远程仓库：

# 推送所有重命名后的本地分支到远程，建立跟踪关系
git push origin --all

# 清理远程仓库上的旧分支
while read -r old_name; do
    # 跳过核心分支，不执行删除
    if [[ "$old_name" =~ ^(master|develop)$ ]] || [[ "$old_name" =~ ^(bugfix|hotfix|release|feature)/ ]]; then
        continue
    fi
    echo "删除远程旧分支: origin/$old_name"
    git push origin --delete "$old_name"
done < old_branch_backup.txt

# 清理临时备份文件
rm old_branch_backup.txt

注意事项 #

• 脚本用git for-each-ref获取分支列表，避免解析git branch的人可读输出时被*、空格等特殊字符干扰，兼容性更好。
• 特殊字符替换用tr命令实现全局替换，不会出现仅替换第一个匹配字符的问题，大写转小写逻辑通过tr的字符集转换实现，兼容所有大小写字母场景。
• 所有重命名操作先在本地执行，确认结果正确后再操作远程，避免误操作影响团队协作。

内容的提问来源于stack exchange，提问作者PRAVEEN SINGH Pokharia