在GitLab共享流水线模板中实现commitlint校验MR所有提交遇阻

问题根源 #

你之前用--from $CI_MERGE_REQUEST_DIFF_BASE_SHA --to $CI_COMMIT_SHA无效，核心原因是GitLab MR流水线默认采用浅克隆拉取源分支代码，本地仓库里没有目标分支的提交记录，导致无法识别CI_MERGE_REQUEST_DIFF_BASE_SHA对应的基准提交，自然无法遍历校验区间内的所有提交。

实现方案 #

在共享流水线模板中编写commitlint作业，区分普通推送和MR两种场景，分别执行不同的校验逻辑：

完整作业示例 #

commitlint-check:
  stage: lint
  image: node:latest # 按需选择合适的Node镜像
  script:
    # 安装commitlint依赖（如果项目未预先安装）
    - npm install @commitlint/cli @commitlint/config-conventional --no-save
    # 分支场景判断与校验逻辑
    - |
      if [ -n "$CI_MERGE_REQUEST_ID" ]; then
        # MR场景：拉取目标分支完整代码，计算合并基准点
        git fetch origin $CI_MERGE_REQUEST_TARGET_BRANCH_NAME
        MERGE_BASE=$(git merge-base origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME $CI_COMMIT_SHA)
        # 校验基准点到当前提交的所有MR新增提交
        npx commitlint --from $MERGE_BASE --to $CI_COMMIT_SHA
      else
        # 普通推送场景：仅校验最新提交
        npx commitlint --from HEAD~1 --to HEAD
      fi
  rules:
    # 仅在代码推送或MR触发时执行
    - if: $CI_PIPELINE_SOURCE == "push" || $CI_PIPELINE_SOURCE == "merge_request_event"

关键细节说明 #

• 浅克隆处理：通过git fetch origin $CI_MERGE_REQUEST_TARGET_BRANCH_NAME拉取目标分支的完整提交记录，确保本地能找到合并基准点
• 合并基准计算：git merge-base会自动找到源分支与目标分支的最近共同提交，精准覆盖MR中所有新增的提交
• 场景区分：用CI_MERGE_REQUEST_ID判断是否处于MR场景，避免普通推送时执行冗余操作

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