GitHub 仓库如何设置默认分支保护：Rulesets 创建与生效检查

团队把代码合进默认分支前，最容易漏掉的不是“有没有写规则”，而是规则是否真的挂到了目标分支。GitHub 网页里的 Rulesets 可以把目标分支、拉取请求审查、状态检查和绕过权限放在一条规则里；创建后看到 Active，才说明它开始执行。

先把任务边界定清楚：保护默认分支的合并入口

这次只做一条仓库级分支 Ruleset：目标是默认分支，要求通过拉取请求合并，并保留状态检查的位置。它不是 Git 命令教程，也不修改组织级规则。你需要对目标仓库有管理员权限，或者拥有 GitHub 文档所说的编辑仓库规则权限。

第1步：从仓库主页进入 Rulesets

打开目标仓库，点击顶部的 Settings。进入设置后，在左侧的 Code and automation 区域展开 Rules，点击 Rulesets。

截图中的仓库导航显示 Settings 位于顶部右侧。成功进入后，浏览器地址会切换到仓库设置区域，左侧菜单能看到 Rules 分组；如果没有 Settings，先检查当前账号的仓库权限，不要继续猜 URL。

第2步：新建规则并限定默认分支

在 Rulesets 页面点击 New ruleset，选择 New branch ruleset。填写规则名称，在 Enforcement status 先选择 Evaluate 进行验证；在 Target branches 中选择默认分支或使用分支选择器精确匹配它。

然后按仓库的合并流程勾选 Require a pull request before merging。如果 CI 已经有稳定的检查，再添加 Require status checks to pass，并选择实际存在的检查名称。不要为了“看起来完整”填写不存在的检查。

这张官方界面截图对应设置路径：General → Code and automation → Rules → Rulesets。进入该页后，页面上方应出现新建规则的入口；如果看到的是只读列表，通常是权限不足。

第3步：保存并核对 Active 状态

确认目标分支、拉取请求审查人数、状态检查和 Bypass list 后，点击页面底部的 Create。验证阶段使用 Evaluate 时，规则只记录匹配结果；确认范围无误后编辑这条 Ruleset，把 Enforcement status 改为 Active 并保存。

回到 Rulesets 列表，核对三项：规则名称与刚才填写的一致，目标分支不是空范围，状态显示为 Active。随后用一个测试拉取请求验证：未满足审批或状态检查时，合并按钮应显示阻止原因；符合条件后才允许合并。

常见误区：规则存在不等于规则正在拦截

相关问题

Rulesets 和旧的 Branch protection rules 需要同时配置吗？

不建议为了同一条默认分支重复配置。先确认仓库当前采用的规则入口，再集中维护一套清晰的条件，减少两套规则互相解释不清。

什么时候应该直接使用 Active？

目标分支和检查名称已经在测试拉取请求中验证过，再切换到 Active。第一次配置可先用 Evaluate 观察匹配范围。

为什么创建按钮不可用？

先检查必填名称、目标分支和规则类型，再确认账号具备管理员或编辑仓库规则权限。

最后确认

一条可交付的默认分支 Ruleset 至少要能回答：它保护哪个分支、要求哪些合并条件、谁能绕过、当前是否 Active。把这四项写进团队变更记录，后续排查合并受阻时会比重新翻设置页快得多。