如何限制Git分支命名仅允许bug和enhancement作为合法文件夹前缀？

架构老林

2026-7-16

限制Git分支命名，强制合法前缀文件夹

一、服务器端强制：用预接收钩子拦截不符合规范的分支

这是最有效的根源解决方案，直接在远程仓库部署pre-receive钩子，在推送完成前检查分支名格式，不符合就拒绝推送。

登录Git服务器，找到目标仓库的hooks目录（默认路径为repo.git/hooks/）
创建pre-receive文件，写入以下bash脚本：

#!/bin/bash

# 遍历所有待推送的分支引用
while read oldrev newrev refname; do
    # 提取纯分支名（去掉refs/heads/前缀）
    branch_name=${refname#refs/heads/}
    
    # 检查分支是否以bug/或enhancement/开头（严格匹配小写）
    if [[ ! $branch_name =~ ^bug/ && ! $branch_name =~ ^enhancement/ ]]; then
        echo "错误：分支命名不符合规范，必须以bug/或enhancement/开头（严格小写）"
        echo "示例：bug/123_fix_login_crash 或 enhancement/456_add_dark_mode"
        exit 1 # 非0退出码会直接拦截推送
    fi
done

exit 0

给脚本添加执行权限：chmod +x pre-receive

之后任何不符合前缀规范的分支推送都会被直接拦截，彻底杜绝错误命名的分支进入远程仓库。

二、本地端辅助：用Git别名简化规范分支创建

给团队成员配置Git别名，减少手动输入时的大小写错误：

git config --global alias.create-branch '!f() { 
    if [ "$1" = "bug" ] || [ "$1" = "enhancement" ]; then
        git checkout -b "$1/$2_$3"
    else
        echo "错误：前缀只能是bug或enhancement（小写）"
    fi
}; f'

使用时直接运行：git create-branch bug 123_fix_login_error，就能自动生成符合规范的分支bug/123_fix_login_error。