如何在GitHub远程仓库创建分支时主动强制执行命名规范？

可行方案：GitHub Rulesets+自定义校验，或自托管端钩子 #

目前GitHub原生工具里，GitHub Rulesets是最接近实时拦截无效分支的方案，但默认配置确实覆盖不了所有细节（比如字符限制）。不过可以通过以下方式实现完整规则：

1. 先靠Rulesets锁死前缀 #

在仓库的「Settings」→「Rulesets」新建规则：

• 选择「Branch name pattern」，添加这几个匹配规则：
  • feature/JIRA-*
  • bugfix/JIRA-*
  • hotfix/JIRA-*
  • release/JIRA-*
• 设置规则为仅允许匹配这些模式的分支被创建/推送，直接把feat/、bug/这类不符合要求的前缀分支拦在门外。

2. 补全字符限制的校验 #

Rulesets没法直接设置字符长度限制，可以选下面两种方式补充：

• GitHub App + Webhook方案：注册一个GitHub App，开启仓库的「Contents」权限，监听create（分支创建）和push事件。当分支创建/推送后立刻校验名称，要是描述部分超过30字符，直接调用GitHub API删除该分支，同时给推送者发通知。
• 自托管GitHub Enterprise方案：如果用的是自托管版本，直接在服务器的仓库目录下添加hooks/pre-receive脚本，推送时实时校验，不符合规则就直接拒绝：

#!/bin/bash
while read oldrev newrev refname; do
    branch=$(git rev-parse --symbolic --abbrev-ref $refname)
    # 匹配前缀+工单编号+30字符以内的描述
    if ! [[ $branch =~ ^(feature|bugfix|hotfix|release)/JIRA-[0-9]+-.{1,30}$ ]]; then
        echo "分支名称无效：$branch"
        echo "要求格式：[feature/bugfix/hotfix/release]/JIRA-<工单编号>-<描述（最多30字符）>"
        exit 1
    fi
done
exit 0

给脚本添加执行权限chmod +x pre-receive即可，这个方案能在推送时直接拦截，完全无法绕过。

关于Rulesets字符限制的小技巧 #

不想额外开发的话，也可以用更精确的正则在Rulesets里近似实现字符限制：
把分支匹配规则写成feature/JIRA-[0-9]+-.{1,30}$，这里的.{1,30}就限制了描述部分最多30个字符，虽然没法精确计算总长度，但基本能满足大部分场景需求。

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