Azure Pipeline命令行脚本提取无路径分支名赋值变量报错排查

问题复现 #

在Azure Pipeline的Command Line Script任务中编写如下逻辑，试图提取PR源分支的纯分支名：

$branchSource = "$(System.PullRequest.SourceBranch)"
$branchSourcePath = $branchSource -replace "refs/heads/", ""

预期逻辑为：

• 将refs/heads/branchName格式的完整源分支路径赋值给$branchSource变量
• 移除路径中的refs/heads/前缀，将得到的纯分支名存入$branchSourcePath变量

实际流水线运行时抛出如下错误：

/Users/myagent/path/*******-********.sh: line 2: =: command not found
/Users/myagent/path/*******-********.sh: line 3: =: command not found

单独执行echo "$(System.PullRequest.SourceBranch)"可以正常输出完整分支路径，变量本身取值正常。

根因分析 #

报错核心是脚本语法和任务默认解释器不匹配：

• macOS/Linux代理上的Command Line Script任务默认使用bash作为脚本解释器，编写的PowerShell语法无法被bash识别
• bash语法强制要求变量赋值时=两侧不能有空格，$branchSource = "xxx"的写法会被bash解析为「执行$branchSource对应的命令，传入=和后续字符串作为参数」，因此抛出=: command not found错误
• bash不支持PowerShell特有的-replace字符串替换操作符，即使修正赋值空格问题，替换逻辑也无法正常执行

可行解决方案 #

根据脚本使用习惯二选一即可：

方案1：保留默认Command Line任务，改用bash语法 #

直接将脚本替换为bash兼容写法，使用bash内置字符串裁剪能力移除前缀，无需依赖额外命令：

# 变量赋值等号两侧不要加空格
branchSource="$(System.PullRequest.SourceBranch)"
# 内置语法裁剪开头的refs/heads/前缀
branchSourcePath="${branchSource#refs/heads/}"

# 可加打印验证结果
echo "提取得到的纯分支名：$branchSourcePath"

提示：如果需要兼容PR来自fork仓库、tag触发等特殊ref场景，可以将裁剪逻辑替换为branchSourcePath="${branchSource##*/}"，直接取最后一个/后的内容，适配所有ref格式。

方案2：切换为PowerShell任务类型，保留原有PowerShell语法 #

如果更熟悉PowerShell语法，不需要修改原有代码，只需要把任务类型从「Command Line Script」切换为「PowerShell」任务即可，原有代码可以直接正常运行：

$branchSource = "$(System.PullRequest.SourceBranch)"
$branchSourcePath = $branchSource -replace "refs/heads/", ""
Write-Host "提取得到的纯分支名：$branchSourcePath"

内容的提问来源于stack exchange，提问作者Mr. Mayonnaise