非多分支Azure Pipeline中获取分支名返回HEAD的问题

Azure Pipeline默认采用**浅克隆（--depth 1）**方式拉取代码，且处于分离HEAD（detached HEAD）状态——这种模式下本地仓库没有关联的分支引用，所以你执行的git rev-parse --abbrev-ref HEAD等命令都会返回HEAD，而非实际分支名。

下面提供两种可行解决方案：

方案一：修改Pipeline克隆配置，获取完整分支信息 #

通过调整Pipeline的拉取参数，让仓库拉取完整历史并保留分支关联：

• YAML流水线配置：

steps:
- checkout: self
  fetchDepth: 0  # 拉取完整仓库历史，而非仅最新提交
  persistCredentials: true  # 保留凭证，确保能读取分支信息

• 经典编辑器配置：在仓库的"高级"设置中，关闭"浅克隆"选项，将"获取深度"设为0。

修改后再执行你原来的git命令，就能正常返回分支名称。

方案二：直接使用Azure Pipeline预定义变量（推荐） #

无需依赖git命令，直接读取Pipeline内置的环境变量BUILD_SOURCEBRANCHNAME，它会直接返回当前分支名，不受克隆状态影响。Java代码中获取方式如下：

String branchName = System.getenv("BUILD_SOURCEBRANCHNAME");
return branchName;

这种方式更高效，也避免了git命令的各种环境依赖问题，完全适配非多分支流水线的需求。

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