如何实现GitLab Merge Request模板全选复选框后启用合并按钮？

针对GitLab原生不支持的「MR模板复选框全勾选后启用合并按钮+显示完成数量」需求，有以下几种可行方案：

方案一：CI/CD流水线校验（无客户端依赖，强制约束） #

通过GitLab CI/CD作业自动校验MR描述中的复选框状态，未全部勾选则阻止合并，同时输出完成数量。

实现步骤： #

1. 标准化MR模板：确保模板中的任务项统一使用- [ ]（未勾选）或- [x]（已勾选）格式，示例模板：

待完成任务清单 #

• 代码通过单元测试
• 关联文档已同步更新
• 已完成代码评审

2. 编写CI作业脚本：

check_mr_checkboxes:
  stage: pre-merge
  only:
    - merge_requests
  script:
    # 获取当前MR的描述内容
    MR_DESCRIPTION=$(curl --header "PRIVATE-TOKEN: $GITLAB_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/merge_requests/$CI_MERGE_REQUEST_IID" | jq -r '.description')
    
    # 统计总复选框数和已勾选数
    TOTAL_CHECKBOXES=$(echo "$MR_DESCRIPTION" | grep -cE '^\s*- \[.\]')
    COMPLETED_CHECKBOXES=$(echo "$MR_DESCRIPTION" | grep -cE '^\s*- \[x\]')
    
    echo "任务完成进度：$COMPLETED_CHECKBOXES/$TOTAL_CHECKBOXES"
    
    # 未全部勾选则终止流水线
    if [ "$COMPLETED_CHECKBOXES" -ne "$TOTAL_CHECKBOXES" ]; then
      echo "错误：存在未完成的任务，请勾选所有复选框后重试"
      exit 1
    fi

• 需在项目CI/CD变量中配置GITLAB_TOKEN，权限需包含「读取合并请求」。
• 优点：无需客户端修改，所有提交者都受约束；缺点：只能在CI阶段反馈，无法实时在MR页面显示进度。

方案二：浏览器用户脚本（实时前端反馈） #

通过Tampermonkey等用户脚本工具，在MR页面注入逻辑，实时统计复选框完成数量并控制合并按钮状态。

实现脚本示例： #

// ==UserScript==
// @name         GitLab MR 任务进度控制
// @match        https://你的GitLab实例地址/*/merge_requests/*
// @grant        none
// ==/UserScript==

(function() {
    'use strict';

    function updateStatus() {
        // 获取MR描述中的所有复选框
        const checkboxes = document.querySelectorAll('.issuable-description li input[type="checkbox"]');
        if (checkboxes.length === 0) return;

        const total = checkboxes.length;
        const completed = Array.from(checkboxes).�obs筛选/application;/**计划 boolean TR四个九表情行文字子元素筛选已勾选的复选框*/filter(cb => cb.checked).length;

        // 显示进度信息
        let statusBar = document.getElementById('mr-task-progress');
        if (!statusBar) {
            statusBar = document.createElement('div');
            statusBar.id = 'mr-task-progress';
            statusBar.style.margin = '16px 0';
            statusBar.style.padding = '8px';
            statusBar.style.backgroundColor = '#f0f0f0';
            document.querySelector('.issuable-description').appendChild(statusBar);
        }
        statusBar.textContent = `任务完成进度：${completed}/${total}`;

        // 控制合并按钮
        const mergeBtn = document.querySelector('.js-merge-button');
        if (mergeBtn) {
            mergeBtn.disabled = completed !== total;
            mergeBtn.classList.toggle('is-disabled', completed !== total);
        }
    }

    // 监听复选框变化
    document.addEventListener('change', e => {
        if (e.target.type === 'checkbox' && e.target.closest('.issuable-description')) {
            updateStatus();
        }
    });

    // 页面加载后初始化
    setTimeout(updateStatus, 1000);
})();

• 替换@match中的GitLab实例地址后，安装到Tampermonkey即可使用。
• 优点：实时显示进度，动态控制合并按钮；缺点：需每个用户手动安装脚本，无法强制约束（用户可禁用脚本）。

方案三：自托管GitLab自定义插件（企业级解决方案） #

如果使用自托管GitLab实例，可通过开发自定义插件或利用GitLab的扩展API实现完整功能：

1. 监听MR描述的更新事件，后台校验复选框状态；
2. 动态控制合并按钮的可用性，拒绝未完成任务的合并请求；
3. 在MR页面注入自定义UI组件，实时展示任务完成数量。

该方案需要具备GitLab插件开发能力，适合有专业运维团队的企业环境，能实现最完善的约束与反馈体验。

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