GitLab CI/CD PowerShell执行器下如何获取MR变更文件列表？

问题根源 #

你遇到的fatal: ambiguous argument错误，本质是两个问题：一是GitLab Runner默认的浅克隆没拉全远程分支的引用，二是git diff的参数格式在PowerShell里没写对。

修复方案 #

1. 拉取完整仓库历史 #

CI默认是浅克隆，会导致找不到目标分支的完整引用，先在变量里禁用浅克隆：

variables:
  GIT_DEPTH: 0  # 拉取完整仓库，避免分支引用缺失

2. 修正git diff写法 #

PowerShell里执行git命令时，分支对比格式要准确，还要先拉取最新远程分支信息：

# 拉取远程最新分支数据
git fetch origin

# 从GitLab CI自带变量里获取MR的源分支和目标分支
$source = $env:CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
$target = $env:CI_MERGE_REQUEST_TARGET_BRANCH_NAME

# 执行diff获取变更文件列表
git diff --name-only "origin/$target...origin/$source"

3. 规避PowerShell参数解析坑 #

如果还是报错，用&调用git命令，确保参数正确传递：

& git diff --name-only "origin/$($target)...origin/$($source)"

4. 验证变量有效性 #

可以先打印变量确认分支名是否正常获取，避免空值引发错误：

Write-Host "源分支: $env:CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
Write-Host "目标分支: $env:CI_MERGE_REQUEST_TARGET_BRANCH_NAME"

完整可用的CI脚本示例 #

stages:
  - get_mr_changes

fetch-mr-changes:
  stage: get_mr_changes
  tags:
    - powershell-runner  # 替换成你的PowerShell Runner标签
  variables:
    GIT_DEPTH: 0
  script:
    - git fetch origin
    - $sourceBranch = $env:CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
    - $targetBranch = $env:CI_MERGE_REQUEST_TARGET_BRANCH_NAME
    - Write-Host "对比分支: origin/$targetBranch...origin/$sourceBranch"
    - git diff --name-only "origin/$targetBranch...origin/$sourceBranch"
  only:
    - merge_requests  # 仅在MR触发时执行

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