Azure DevOps中无法获取Pull Request的源/目标分支问题排查

源代码仓库托管在GitHub，流水线部署于Azure DevOps。已成功通过Pull Request（PR）触发流水线，但在YAML流水线中尝试获取PR相关属性时，所有变量值均提示‘command not found’错误，需排查诱因及修正获取方式。

用户提供的YAML流水线代码 #

trigger:
  branches:
    include:
    - feature/azure-pipeline
    - develop
    - release/*
    exclude:
    - features/*
    - master
pr:
  branches:
    include:
      - develop
      - main

stages:

  - stage: TestStage 
    jobs:

    - job: unit_test
      displayName: 'Unit test Job'
      pool:
       vmImage: 'macos-latest'
      

      variables:
      - name: currentBranch
        ${{ if eq(variables['Build.Reason'], 'PullRequest') }}:
         value: $(System.PullRequest.TargetBranch)
        ${{ if ne(variables['Build.Reason'], 'PullRequest') }}:
         value: $(Build.SourceBranch)

      steps:
      - task: DownloadSecureFile@1
        displayName: 'Download CSSM secrets'
        name: secureKeys
        inputs:
          secureFile: 'cssmkeys.properties'
      - script: |
         echo Target Branch is $(System.PullRequest.TargetBranch)
         echo Source Repository URI is $(System.PullRequest.SourceRepositoryURI)    
         echo PullRequest Id is $(System.PullRequest.PullRequestId)
         echo Source Branch is $(System.PullRequest.SourceBranch)   
         echo Current Branch is $(value)

错误输出截图 #

问题诱因及修正方案 #

1. 核心诱因：脚本中变量调用格式错误 #

Azure DevOps的系统变量在YAML配置段（如变量定义、条件判断）中使用$(Variable.Name)格式，但在**shell脚本（bash/zsh）**中，这类格式会被解析为执行命令，而非读取变量值——因为$(xxx)是shell的命令替换语法，而System.PullRequest.TargetBranch并非可执行命令，因此触发command not found错误。

2. 次要问题：自定义变量引用错误 #

最后一行echo Current Branch is $(value)是无效引用，正确写法应为$(currentBranch)，对应你定义的自定义变量名。

修正后的关键代码片段 #

steps:
- task: DownloadSecureFile@1
  displayName: 'Download CSSM secrets'
  name: secureKeys
  inputs:
    secureFile: 'cssmkeys.properties'
- script: |
   echo Target Branch is $SYSTEM_PULLREQUEST_TARGETBRANCH
   echo Source Repository URI is $SYSTEM_PULLREQUEST_SOURCEREPOSITORYURI    
   echo PullRequest Id is $SYSTEM_PULLREQUEST_PULLREQUESTID
   echo Source Branch is $SYSTEM_PULLREQUEST_SOURCEBRANCH   
   echo Current Branch is $(currentBranch)

变量调用规则说明 #

Azure DevOps系统变量在不同环境中的调用格式不同：

• YAML配置段（变量、条件、任务参数）：使用$(Variable.Name)格式
• bash/zsh脚本：使用$VARIABLE_NAME格式（变量名全大写，原变量中的点号替换为下划线）
• PowerShell脚本：使用$env:Variable.Name或$env:VARIABLE_NAME格式

补充说明：Azure DevOps官方提供了流水线构建变量的详细文档，涵盖各类变量的适用场景与调用方式。

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