Azure Pipeline获取PR源/目标分支名称问题求助

核心前提 #

System.PullRequest.SourceBranch 和对应的环境变量 SYSTEM_PULLREQUEST_SOURCEBRANCH 仅在Pull Request触发的Pipeline运行时才会被自动填充。如果你的Pipeline是手动触发、分支推送触发或其他非PR触发方式，这些变量会是空值或无法识别。

正确的变量使用方式 #

方式1：使用环境变量（PowerShell中） #

在PowerShell inline脚本中，环境变量名采用全大写、下划线分隔的格式，变量值默认带refs/heads/前缀，可按需截取纯分支名：

task: PowerShell@2
displayName: 'Detect file changes'
inputs: 
  targetType: 'inline'
  script: |
    # 获取带refs/heads/前缀的源分支
    $sourceBranch = $env:SYSTEM_PULLREQUEST_SOURCEBRANCH
    Write-Host "源分支（带前缀）：$sourceBranch"

    # 截取纯分支名
    $pureSourceBranch = $sourceBranch -replace 'refs/heads/', ''
    Write-Host "源分支（纯名称）：$pureSourceBranch"

    # 获取目标分支并处理
    $targetBranch = $env:SYSTEM_PULLREQUEST_TARGETBRANCH
    $pureTargetBranch = $targetBranch -replace 'refs/heads/', ''
    Write-Host "目标分支（纯名称）：$pureTargetBranch"

方式2：使用Azure Pipeline变量语法（YAML层面替换） #

如果要直接用$(System.PullRequest.SourceBranch)格式，需让YAML先完成变量替换再传给PowerShell执行，写法如下：

task: PowerShell@2
displayName: 'Detect file changes'
inputs: 
  targetType: 'inline'
  script: |
    $sourceBranch = "$(System.PullRequest.SourceBranch)"
    Write-Host "源分支：$sourceBranch"

注意：不要在PowerShell脚本里直接写$(System.PullRequest.SourceBranch)而不加引号，否则PowerShell会将其当作命令执行，导致"object not found"错误。

排查步骤 #

1. 确认触发方式：检查Pipeline触发设置，确保已启用Pull Request触发（YAML中通过pr:配置，或在门户界面开启PR触发）。
2. 验证变量存在性：在脚本中添加命令，确认是否存在PR相关环境变量：

   Get-ChildItem Env: | Where-Object Name -like 'SYSTEM_PULLREQUEST*'
   

3. 检查权限：如果连接的是外部代码仓库（如GitHub），确认服务连接有足够权限读取Pull Request信息。

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