如何配置GitLab code_quality仅分析合并请求中的变更文件？

GitLab官方的Code Quality模板目前没有原生支持仅分析变更文件的功能，你提到的相关开放议题也说明该需求尚未被官方正式实现。不过可以通过以下几种变通方案达成目标：

方案1：自定义CI任务，基于Git变更文件调用CodeClimate工具 #

官方Code Quality底层依赖CodeClimate工具，我们可以绕过官方模板，直接在CI脚本中筛选变更文件并执行分析：

1. 提取MR变更文件
   使用Git命令获取当前MR与目标分支的差异文件，过滤出需要分析的代码类型：

   # 定义目标分支，默认取MR的目标分支， fallback到main
   TARGET_BRANCH=${CI_MERGE_REQUEST_TARGET_BRANCH_NAME:-main}
   # 获取变更且存在的代码文件，这里的正则匹配你项目的代码后缀，按需修改
   CHANGED_FILES=$(git diff --name-only $TARGET_BRANCH...HEAD | grep -E '\.(js|py|java|rb|vue)$' | xargs ls 2>/dev/null || true)
   

2. 自定义CI配置
   替换原有code_quality任务，直接调用CodeClimate分析变更文件：

   stages:
     - test
   
   code_quality:
     stage: test
     rules:
       - if: $CI_PIPELINE_SOURCE == "merge_request_event"
     image: codeclimate/codeclimate:latest
     variables:
       REPORT_FORMAT: html
     script:
       - TARGET_BRANCH=${CI_MERGE_REQUEST_TARGET_BRANCH_NAME:-main}
       - CHANGED_FILES=$(git diff --name-only $TARGET_BRANCH...HEAD | grep -E '\.(js|py)$' | xargs ls 2>/dev/null || true)
       # 仅当有变更文件时执行分析，否则生成空报告避免CI失败
       - if [ -n "$CHANGED_FILES" ]; then codeclimate analyze $CHANGED_FILES -f html > gl-code-quality-report.html; else touch gl-code-quality-report.html; fi
     artifacts:
       paths: [gl-code-quality-report.html]
     tags:
       - code-quality
   

方案2：动态生成CodeClimate排除规则 #

通过动态修改.codeclimate.yml的exclude_paths，排除所有未变更的文件：

code_quality:
  stage: test
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  image: codeclimate/codeclimate:latest
  variables:
    REPORT_FORMAT: html
  script:
    - TARGET_BRANCH=${CI_MERGE_REQUEST_TARGET_BRANCH_NAME:-main}
    - CHANGED_FILES=$(git diff --name-only $TARGET_BRANCH...HEAD | grep -E '\.(js|py)$' || true)
    # 生成未变更文件列表，用于排除
    - ALL_FILES=$(find . -type f -name "*.js" -o -name "*.py" | grep -v '^\./\.')
    - UNCHANGED_FILES=$(echo "$ALL_FILES" | grep -v -F "$CHANGED_FILES")
    # 生成临时CodeClimate配置
    - echo "exclude_paths:" > .codeclimate.tmp.yml
    - echo "$UNCHANGED_FILES" | sed 's/^/- /' >> .codeclimate.tmp.yml
    # 合并原有配置（如果存在）
    - if [ -f .codeclimate.yml ]; then yq merge .codeclimate.yml .codeclimate.tmp.yml > .codeclimate.yml; else mv .codeclimate.tmp.yml .codeclimate.yml; fi
    - codeclimate analyze -f html > gl-code-quality-report.html
  artifacts:
    paths: [gl-code-quality-report.html]
  tags:
    - code-quality
  before_script:
    # 安装yq用于合并YAML，根据镜像调整安装命令
    - apt-get update && apt-get install -y yq

注意：该方案需要CI环境安装yq工具，且当项目文件较多时，排除列表会很长，性能不如方案1。

方案3：基于SonarQube增量扫描（进阶） #

如果团队有条件部署SonarQube服务，可以使用SonarQube的增量扫描功能，仅分析变更文件。这种方案需要配置SonarQube的CI集成，适合长期维护的大型项目。

关键注意事项 #

• 上述方案仅针对MR事件生效，若需支持分支推送场景，需修改Git命令（比如对比上一次提交git diff --name-only HEAD~1）。
• 确保CI Runner有权限拉取目标分支的完整代码，避免Git diff失败。

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