如何在GitHub组织级启用分支保护规则实现仓库继承？

可以在GitHub组织层面启用分支保护规则，让组织内所有仓库的对应分支自动继承，无需逐个仓库重复配置，具体实现方式有两种：

一、使用GitHub原生组织级分支保护规则（推荐） #

这是GitHub官方提供的原生功能，操作简单且能自动覆盖现有和新建仓库：

• 登录GitHub，进入你的组织主页，点击顶部的「Settings」
• 在左侧菜单找到「Repository policies」→「Branch protection rules」
• 点击「Add branch protection rule」，设置以下关键项：
  • Branch name pattern：填写要保护的分支模式，比如main、release/*支持通配符匹配多个分支
  • 勾选需要的保护规则，比如「Require a pull request before merging」「Require status checks to pass before merging」「Require code owner reviews」等
  • 按需开启「Enforce for admins」确保管理员也受规则约束
• 保存后，该规则会自动应用到组织内所有仓库，若个别仓库需要例外，可在仓库的分支保护设置中勾选「Override organization settings」自定义规则（仓库级规则优先级高于组织级）

二、通过API/脚本批量配置（适合定制化需求） #

如果原生组织规则无法满足特殊需求，可通过GitHub API编写脚本批量更新所有仓库的分支保护：

• 准备一个拥有组织管理员权限的GitHub个人访问令牌（PAT），需包含repo权限
• 示例bash脚本（结合jq工具）：

# 替换为你的组织名和PAT
ORG_NAME="your-org"
TOKEN="your-personal-access-token"
TARGET_BRANCH="main"

# 获取组织内所有仓库列表
REPOS=$(curl -s -H "Authorization: token $TOKEN" "https://api.github.com/orgs/$ORG_NAME/repos" | jq -r '.[].name')

# 遍历仓库设置分支保护规则
for REPO in $REPOS; do
  curl -X PUT -s -H "Authorization: token $TOKEN" \
    -H "Content-Type: application/json" \
    "https://api.github.com/repos/$ORG_NAME/$REPO/branches/$TARGET_BRANCH/protection" \
    -d '{
      "required_pull_request_reviews": {
        "required_approving_review_count": 1
      },
      "enforce_admins": true,
      "required_status_checks": {
        "strict": true,
        "contexts": ["ci/test"]
      }
    }'
done

• 也可以用GitHub Actions编写工作流，定时触发或在组织新增仓库时自动执行配置，实现全自动化维护

注意事项 #

• 组织级规则默认对所有仓库生效，例外仓库需手动开启覆盖
• 操作前建议先在测试仓库验证规则效果，避免影响正常业务
• 使用API时确保令牌权限足够，且妥善保管令牌避免泄露

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