Azure发布管道YAML中PowerShell命令执行失败及环境变量映射问题

1. 搞定PowerShell空值表达式错误 #

PowerShell命令报错的核心原因是：发布管道里默认没有BUILD_SOURCEBRANCH这个环境变量，导致$env:build_sourceBranch是空值，调用substring和indexOf方法自然会报错。

正确获取分支名称的方法 #

在Azure发布管道里，要拿触发发布的分支名，直接用内置变量$(Build.SourceBranchName)就行，但得注意引用方式：

• 要是内联PowerShell，直接写$branch = "$(Build.SourceBranchName)"
• 要是用独立脚本文件，要么通过YAML把变量注入环境，要么在脚本里直接引用管道变量

如果非要手动解析分支路径（比如从refs/heads/main里提取分支名），可以写个更安全的版本，避免空值报错：

# 优先用环境变量，没有就用内置变量
$branchSource = $env:BUILD_SOURCEBRANCH ?? "$(Build.SourceBranchName)"
if (-not [string]::IsNullOrEmpty($branchSource)) {
    $slashIndex = $branchSource.IndexOf('/', 5)
    $branch = $slashIndex -ge 0 ? $branchSource.Substring($slashIndex + 1) : $branchSource.Split('/')[-1]
} else {
    $branch = "default-branch" # 设个默认值，防止后续流程卡壳
}

2. 修复YAML环境变量映射的语法错误 #

你碰到的A mapping was not expected是YAML缩进或格式写错了。正确的环境变量映射要注意两点：

• 缩进统一（建议用2个空格，别混制表符）
• env块要和步骤里的其他属性（比如inputs）同级对齐

举个正确的例子：

steps:
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $branch = $env:BUILD_SOURCEBRANCHNAME
      Write-Host "当前分支：$branch"
  env:
    BUILD_SOURCEBRANCHNAME: $(Build.SourceBranchName)

另外，其实发布管道里Build.SourceBranchName本身就能直接用，没必要多此一举映射环境变量，内联脚本直接这么写就行：

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      $branch = "$(Build.SourceBranchName)"
      Write-Host "分支名称：$branch"

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