如何在GitHub分支校验不通过时禁止创建Pull Request？

核心结论 #

无法直接通过GitHub Actions实现切换目标分支时动态启用/禁用「创建Pull Request」按钮的需求。原因是：

• GitHub UI的交互状态由前端控制，而GitHub Actions是事件驱动的后端工作流，仅能在PR创建/修改后触发，无法实时影响前端UI的交互逻辑。
• GitHub没有提供PR创建前的触发事件或钩子，无法在用户点击「创建PR」前执行分支规则检查。

替代解决方案 #

1. 用GitHub原生分支保护+状态检查强化合并拦截 #

虽然无法阻止创建PR，但可以通过分支保护规则确保不符合要求的PR绝对无法合并，同时强化提示：

• 进入仓库「Settings」→「Branches」→「Branch protection rules」
• 分别为main和develop分支添加规则：
  • 勾选「Require status checks to pass before merging」，将你的分支名称检查工作流添加到必填状态检查列表中
  • 勾选「Require pull request reviews before merging」（可选，进一步加固流程）
  • 勾选「Restrict who can push to matching branches」（可选），仅允许特定团队/用户推送符合命名规则的分支到目标分支

2. 用GitHub Actions自动关闭不符合要求的PR #

在现有工作流中添加步骤，当分支规则检查失败时，自动关闭PR并给出明确提示：
修改你的工作流配置：

on:
  pull_request_target:
    types:
      - opened
      - reopened
      - edited
      - ready_for_review
      - auto_merge_enabled
      - synchronize

jobs:
  branch-validation:
    runs-on: ubuntu-latest
    env:
      # 根据目标分支定义允许的源分支前缀
      ALLOWED_PREFIXES: ${{ 
        github.base_ref == 'main' && 'release' || 
        github.base_ref == 'develop' && 'feature,bug' || 
        '' 
      }}
    steps:
      - name: Check branch name validity
        id: check-branch
        run: |
          SOURCE_BRANCH="${{ github.head_ref }}"
          IFS=',' read -ra PREFIXES <<< "$ALLOWED_PREFIXES"
          VALID=false
          for PREFIX in "${PREFIXES[@]}"; do
            if [[ "$SOURCE_BRANCH" == "$PREFIX"* ]]; then
              VALID=true
              break
            fi
          done
          if [ "$VALID" = false ]; then
            echo "Branch validation failed: Source branch '$SOURCE_BRANCH' does not match allowed prefixes for target branch '${{ github.base_ref }}'"
            exit 1
          fi

      - name: Close invalid PR
        if: failure()
        uses: peter-evans/close-pull-request@v2
        with:
          comment: "❌ 此PR无法创建：目标分支为`${{ github.base_ref }}`时，仅允许`${{ env.ALLOWED_PREFIXES }}*`开头的源分支。请调整分支名称后再提交。"

3. 自定义前端脚本实现实时UI控制（团队内部方案） #

如果需要在GitHub UI中实时禁用「创建PR」按钮，可以编写Tampermonkey类的用户脚本，监听目标分支切换事件并验证分支规则：
示例脚本逻辑（仅作参考）：

// ==UserScript==
// @name         GitHub PR Branch Validation
// @match        https://github.com/*/compare/*
// @grant        none
// ==/UserScript==

(function() {
    'use strict';

    // 定义分支规则：目标分支 → 允许的源分支前缀
    const BRANCH_RULES = {
        'main': ['release'],
        'develop': ['feature', 'bug']
    };

    // 获取目标分支选择器和创建PR按钮
    const targetBranchSelector = document.querySelector('.base-ref-select select');
    const createPrButton = document.querySelector('.btn-primary[data-hotkey="c"]');

    // 验证分支是否符合规则
    function validateBranches() {
        const targetBranch = targetBranchSelector.value.split(':')[1];
        const sourceBranch = window.location.pathname.split('/compare/')[1].split('...')[0];
        const allowedPrefixes = BRANCH_RULES[targetBranch] || [];
        
        const isValid = allowedPrefixes.some(prefix => sourceBranch.startsWith(prefix));
        createPrButton.disabled = !isValid;
        
        // 添加提示文本
        if (!isValid) {
            createPrButton.title = `目标分支${targetBranch}仅允许${allowedPrefixes.join('、')}*开头的源分支`;
        } else {
            createPrButton.title = '';
        }
    }

    // 监听目标分支切换事件
    targetBranchSelector.addEventListener('change', validateBranches);

    // 页面加载时执行一次验证
    validateBranches();
})();

将此脚本分发给团队成员安装，即可在GitHub的PR创建页面实时控制按钮状态。

总结 #

• GitHub原生功能无法实现PR创建前的实时UI拦截，只能通过分支保护+Actions自动关闭的方式阻止不符合要求的PR进入合并流程。
• 自定义前端脚本可以实现实时UI控制，但属于用户端解决方案，需要团队成员统一部署。

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