Azure DevOps中检查修改Python文件格式报错的解决咨询

修复方案 #

原因分析 #

从git branch -a的输出能看到，Pipeline的仓库里只有当前分支的远程引用，没有origin/master——因为没有git fetch权限，仓库未拉取master分支的信息，导致git diff找不到这个目标引用。本地运行正常是因为你的本地仓库已经拉取过master分支，存在origin/master的本地缓存。

具体修复方法 #

1. 用HEAD~1作为基准（单提交分支适用）

如果你的分支基于master创建且只有一次提交，直接对比当前提交与父提交的差异，就能精准获取你修改的文件：

- script: |
    git branch -a
    git diff --name-only HEAD~1...HEAD --diff-filter=AM | grep '\.py$' | xargs black --check 
  displayName: 'Format files'

2. 利用Azure DevOps预定义变量（PR触发场景）

如果是PR触发的Pipeline，使用System.PullRequest.TargetBranch变量获取目标分支（比如master），再处理成Git可识别的格式：

- script: |
    git branch -a
    # 提取目标分支名（去掉refs/heads/前缀）
    BASE_BRANCH=$(echo $(System.PullRequest.TargetBranch) | sed 's/refs\/heads\///')
    git diff --name-only origin/${BASE_BRANCH}...HEAD --diff-filter=AM | grep '\.py$' | xargs black --check 
  displayName: 'Format files'

注意：使用此方法需确保Pipeline启用了"Allow scripts to access the OAuth token"选项，否则无法获取PR相关变量。

3. 手动指定master分支的SHA

如果你能从仓库页面获取到master分支的最新SHA，直接用SHA替换origin/master即可：

- script: |
    git branch -a
    git diff --name-only <master分支SHA>...HEAD --diff-filter=AM | grep '\.py$' | xargs black --check 
  displayName: 'Format files'

将<master分支SHA>替换为实际的SHA值即可。

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