Azure DevOps自动构建Git Diff报错，手动触发正常原因咨询

场景背景 #

• 部署流程：功能上线前需创建PR，完成构建验证后合并PR；PR合并后，目标环境分支自动触发构建部署变更。

问题现象 #

自动构建执行以下命令时触发报错：

git diff --name-only --diff-filter=d HEAD^ HEAD

报错内容：

fatal: ambiguous argument 'HEAD^': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
##[error]Bash exited with code '128'.

但手动触发构建时，这条命令完全正常，部署也能顺利完成。

已尝试的无效方案 #

• git log -1 --name-only --oneline
• 重复执行原命令git diff --name-only --diff-filter=d HEAD^ HEAD
• git diff --name-only --diff-filter=D @~..@

核心原因 #

问题出在自动构建的代码拉取方式是浅克隆（shallow clone），而手动构建通常是完整克隆仓库：

• 浅克隆默认只会拉取最近1次提交的代码，仓库里只有当前最新的一个提交记录，没有HEAD^对应的父提交，Git自然找不到这个引用，就会抛出“未知版本”的错误。
• 手动构建时会拉取完整的仓库提交历史，HEAD^能找到对应的上一次提交，因此命令可以正常执行。

解决办法 #

方案1：调整克隆深度，拉取足够的提交历史 #

在构建的代码拉取步骤中，设置克隆深度为2（至少包含当前提交和父提交）：

git clone --depth 2 <你的仓库地址>

如果用的是GitHub Actions、GitLab CI这类CI工具，直接在checkout步骤里配置参数即可，比如GitHub Actions：

- uses: actions/checkout@v4
  with:
    fetch-depth: 2

方案2：改用不依赖父提交的命令获取变更文件 #

如果无法调整克隆深度，换用基于当前提交直接获取变更的命令：
比如获取当前提交的所有未删除变更文件：

git show --name-only --diff-filter=d --oneline HEAD

另外，很多CI工具会提供环境变量直接返回PR的变更文件列表，比如GitHub Actions可以读取GITHUB_EVENT_PATH里的PR变更数据，GitLab CI可以用CI_MERGE_REQUEST_CHANGES变量，直接用这些变量能避免调用Git命令的问题。

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