Azure DevOps多仓库多分支触发：分支检出规则配置咨询

核心疑问解答 #

1. 特定ref检出是否脱离已定义仓库引用？
   不会。checkout步骤里指定的ref只是针对已在resources.repositories中定义好的仓库，选择具体要检出的分支，完全基于已配置的仓库连接，不存在脱离的情况。

2. 变量使用选择？
   推荐用Build.SourceBranchName（直接获取不带refs/heads/前缀的分支名，比如master、release/1.0），比Build.SourceBranch更简洁。在YAML条件表达式中用${{ variables['Build.SourceBranchName'] }}语法，在步骤属性中可以直接用$(变量名)。

完整配置示例 #

先定义两个仓库的引用，再通过条件变量设置检出分支，最后配置触发规则：

# 定义仓库资源
resources:
  repositories:
    - repository: self
      type: git
      name: 你的主仓库名称 # 替换为实际仓库名
    - repository: UiRepo
      type: git
      name: 你的UiRepo仓库名称 # 替换为实际仓库名

# 设置条件变量，计算要检出的分支
variables:
  - name: SelfCheckoutBranch
    value: ${{ if in(variables['Build.SourceBranchName'], 'master', 'main') }}master${{ else }}${{ variables['Build.SourceBranchName'] }}
  - name: UiRepoCheckoutBranch
    value: ${{ if in(variables['Build.SourceBranchName'], 'master', 'main') }}main${{ else }}${{ variables['Build.SourceBranchName'] }}

# 触发规则：PR完成或直接推送指定分支时触发
trigger:
  branches:
    include:
      - master
      - main
      - release/*
pr:
  branches:
    include:
      - master
      - main
      - release/*

# 检出步骤
steps:
  - checkout: self
    ref: refs/heads/$(SelfCheckoutBranch)
    clean: true # 可选：每次检出前清理工作目录

  - checkout: UiRepo
    ref: refs/heads/$(UiRepoCheckoutBranch)
    clean: true

配置说明 #

• 变量部分通过${{ if }}条件表达式判断触发分支：如果是master或main，则主仓库检出master、UiRepo检出main；否则两个仓库都检出与触发分支同名的分支。
• checkout步骤的ref参数格式为refs/heads/分支名，这是Azure DevOps识别分支的标准格式，确保能准确检出目标分支。
• 触发规则包含了master、main和release/*分支，覆盖PR完成（合并后）和直接推送代码的场景。

内容的提问来源于stack exchange，提问作者Green Grasso Holm