Azure DevOps Pipeline是否有ifExist函数检查分支，不存在时切换默认分支？

Azure DevOps Pipeline 没有内置的ifExist类直接函数来检查分支是否存在，但可以通过脚本任务+动态变量的方式实现你要的逻辑：指定分支不存在时自动切换到默认分支检出。

具体实现方案 #

核心思路是先通过脚本调用Azure DevOps REST API验证分支存在性，设置全局变量后，再根据变量值动态指定仓库的检出分支。

完整流水线配置示例

parameters:
- name: branch
  default: main
  type: string  # 无需用object类型，string更贴合分支名称场景

variables:
  - name: fallbackBranch
    value: main

jobs:
- job: CheckBranchExists
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - bash: |
      # 调用Azure DevOps REST API查询分支是否存在
      BRANCH_RESPONSE=$(curl -s -u :$(System.AccessToken) "https://dev.azure.com/你的组织名/_apis/git/repositories/InternalProjects/esign_new_svc/refs/heads/${{ parameters.branch }}?api-version=7.1-preview.1")
      
      # 用jq判断返回结果是否包含有效分支信息
      if echo "$BRANCH_RESPONSE" | jq '.name != null' | grep -q true; then
        echo "##vso[task.setvariable variable=finalBranch;isOutput=true]${{ parameters.branch }}"
      else
        echo "指定分支 ${{ parameters.branch }} 不存在，将使用默认分支 $(fallbackBranch)"
        echo "##vso[task.setvariable variable=finalBranch;isOutput=true]$(fallbackBranch)"
      fi
    name: BranchCheckStep
    displayName: '检查目标分支是否存在'
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)

- job: CheckoutRepository
  dependsOn: CheckBranchExists
  variables:
    targetBranch: $[ dependencies.CheckBranchExists.outputs['BranchCheckStep.finalBranch'] ]
  steps:
  - checkout: esign_new_svc
    ref: $(targetBranch)
    displayName: '检出仓库 esign_new_svc 到分支 $(targetBranch)'

resources:
  repositories:
  - repository: esign_new_svc
    type: git
    name: InternalProjects/esign_new_svc

关键部分说明 #

1. 分支检查任务：

   • 用Bash脚本调用REST API查询分支状态，通过jq解析返回结果判断分支是否存在
   • 用##vso[task.setvariable]设置输出变量，供后续任务使用
   • 需要在流水线设置中启用「允许脚本访问OAuth令牌」，确保System.AccessToken有权限访问仓库API

2. 动态检出任务：

   • 依赖分支检查任务的输出变量finalBranch
   • 根据变量值自动切换检出分支，避免因分支不存在导致流水线直接失败

3. Windows代理适配：
   如果使用Windows虚拟机代理，可将Bash脚本替换为PowerShell版本：

   $branchName = "${{ parameters.branch }}"
   $orgUrl = "https://dev.azure.com/你的组织名"
   $repoName = "InternalProjects/esign_new_svc"
   $apiVersion = "7.1-preview.1"
   
   $headers = @{ Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN" }
   $url = "$orgUrl/_apis/git/repositories/$repoName/refs/heads/$branchName`?api-version=$apiVersion"
   
   try {
       Invoke-RestMethod -Uri $url -Headers $headers -Method Get | Out-Null
       Write-Host "##vso[task.setvariable variable=finalBranch;isOutput=true]$branchName"
   } catch {
       Write-Host "指定分支 $branchName 不存在，将使用默认分支 $(fallbackBranch)"
       Write-Host "##vso[task.setvariable variable=finalBranch;isOutput=true]$(fallbackBranch)"
   }
   

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