如何设置GitHub PR合并/关闭前必须关联至少一个Issue

架构老林

2026-10-4

PR强制关联Issue的实现方案

主流代码托管平台的原生分支保护规则默认没有内置「PR必须关联至少1个Issue」的校验项，你可以通过以下方案实现需求：

通用方案：配置自动化校验工作流+分支保护规则

该方案适配所有支持CI/CD或自动化工作流的平台（GitHub、Gitee、GitLab等）：

第一步：你可以先配置PR模板，在模板中预留关联Issue的填写位置，引导用户主动按照平台规范填写关联信息，比如GitHub平台的Closes #Issue编号、Fixes #Issue编号语法。
第二步：在仓库中添加校验脚本或工作流任务，扫描PR的标题、正文、提交信息中是否包含合法的关联Issue标识，同时验证对应编号的Issue确实处于仓库开启状态，校验不通过则直接返回失败状态。
第三步：在分支保护规则中，将上述校验工作流设置为必须通过的状态检查，完成配置后，未关联有效Issue的PR会一直处于不可合并状态。