GitHub企业私有组织批量限制分支命名规则方案咨询

官方原生方案 #

• 组织级分支保护规则（仅GitHub Enterprise Cloud/Server可用）：
  进入组织设置的「代码安全和分析」→「分支保护规则」，新建规则时勾选「应用到所有仓库」，在「分支名称模式」中填入正则表达式（比如^[a-z-]+$，匹配小写字母和连字符）。如果部分仓库需要例外，可在规则中指定排除的仓库列表。
• 企业级预接收钩子（仅GitHub Enterprise Server支持）：
  在实例管理控制台配置预接收钩子，编写Shell脚本校验分支名称格式，所有仓库的推送操作都会经过该钩子校验，不符合规则的推送会被直接拒绝。

开源工具/脚本实现 #

• GitHub CLI批量脚本：
  利用GitHub官方CLI工具（gh）编写脚本，批量遍历组织仓库并添加分支保护规则。示例代码片段：

  # 替换为你的组织名称
  ORG="your-org-name"
  # 遍历组织下所有仓库（最多500个）
  gh repo list $ORG --limit 500 --json name | jq -r '.[].name' | while read REPO_NAME; do
    # 通过GitHub API添加分支命名规则
    gh api repos/$ORG/$REPO_NAME/branches/protection/rules \
      -X POST \
      -f name="valid-branch-names" \
      -f pattern="^[a-z-]+$" \
      -f required_status_checks=null \
      -f enforce_admins=null
  done
  

  执行前需确保已通过gh auth login完成认证，且拥有组织仓库的管理员权限。
• 组织级GitHub Actions工作流：
  在组织的.github公共仓库中创建工作流，监听所有仓库的push事件，使用分支名称校验逻辑（比如自定义正则匹配），若分支不符合规则则标记推送失败。只要开启组织仓库对该工作流的继承，就能批量生效。
• 开源分支校验工具：
  借助branch-name-lint这类轻量工具，结合组织级工作流或预接收钩子，快速实现统一的分支命名校验，工具支持自定义正则规则，适配你的需求。

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