如何在Azure DevOps流水线中实现git diff并复制变更文件

问题背景 #

本地运行PowerShell脚本通过git diff --name-only HEAD^ HEAD获取变更文件并复制时正常，但在Azure DevOps流水线中执行时报错，提示找不到HEAD^相关提交历史。原因是Azure DevOps流水线默认采用浅克隆（Shallow Clone），仅拉取最新的1次提交，没有足够的历史记录来识别HEAD^。

原脚本如下：

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $targetfolder = "$(Build.StagingDirectory)" + "/"
      
      function CopyFiles{
          param( [string]$source )
      
          $target = $targetfolder + $source
      
          New-Item -Force $target
          copy-item $source $target -Force
      }
      
      $changes = git diff --name-only --relative --diff-filter AMR HEAD^ HEAD .
      
      if ($changes -is [string]){ CopyFiles $changes }
      else
      {
          if ($changes -is [array])
          {       
              foreach ($change in $changes){ CopyFiles $change }
          }
      }

可行解决方案 #

方案1：调整流水线Git拉取深度 #

修改流水线的代码拉取设置，确保获取至少2次提交的历史：

• YAML流水线：在checkout步骤中添加fetchDepth参数

steps:
- checkout: self
  fetchDepth: 2 # 拉取最新2次提交，足够对比HEAD与HEAD^；设为0可拉取完整历史

• 经典编辑器：在"Get Sources"选项中，将"Shallow fetch depth"改为2（或0）。

这种方式最直接，修改后原脚本无需改动即可正常运行。

方案2：使用Azure DevOps内置变更文件变量 #

Azure DevOps提供了内置变量$(Build.ChangedFiles)，直接返回本次构建的变更文件列表（分号分隔），无需依赖Git历史：

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $targetfolder = "$(Build.StagingDirectory)/"
      
      function CopyFiles{
          param( [string]$source )
          # 先创建目标文件的父目录，避免路径不存在报错
          $targetDir = Split-Path -Path $targetfolder$source -Parent
          New-Item -Path $targetDir -ItemType Directory -Force | Out-Null
          Copy-Item -Path $source -Destination $targetfolder$source -Force
      }
      
      # 拆分分号分隔的文件列表，过滤空字符串
      $changes = $(Build.ChangedFiles) -split ';' | Where-Object { $_ -notmatch '^\s*$' }
      
      foreach ($change in $changes) {
          CopyFiles $change
      }

优势：无需修改Git拉取设置，避免浅克隆限制，稳定性更高。

方案3：在脚本中手动拉取历史提交 #

如果无法修改流水线的拉取设置，可在执行git diff前手动拉取HEAD^对应的提交：

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $targetfolder = "$(Build.StagingDirectory)/"
      
      function CopyFiles{
          param( [string]$source )
      
          $target = $targetfolder + $source
      
          New-Item -Force $target
          copy-item $source $target -Force
      }
      
      # 手动拉取最新2次提交的历史
      git fetch --depth=2 origin HEAD
      
      $changes = git diff --name-only --relative --diff-filter AMR HEAD^ HEAD .
      
      if ($changes -is [string]){ CopyFiles $changes }
      else
      {
          if ($changes -is [array])
          {       
              foreach ($change in $changes){ CopyFiles $change }
          }
      }

注意：需要确保流水线的服务账号有Git仓库的拉取权限。

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