Azure DevOps浅克隆后无法推送至master分支的解决方法

核心原因 #

使用fetchDepth: 3进行浅克隆时，Azure DevOps的checkout任务默认仅拉取触发当前流水线的分支，不会同步master分支的本地引用。后续执行git推送或分支操作时，本地git仓库没有master分支的相关信息，因此抛出匹配失败的错误。

直接解决方案 #

1. 调整checkout任务，显式拉取master分支引用 #

修改checkout步骤，添加fetchRefs参数指定拉取master分支，确保浅克隆时同步该分支的头部引用：

- checkout: self
  persistCredentials: false
  clean: true
  displayName: Checkout and clean
  fetchDepth: 3 # 浅克隆保留最近3次提交
  fetchRefs: |
    refs/heads/master

2. 修正git推送命令 #

推送时明确指定远程仓库的master分支，无需依赖本地master分支引用：

git push https://XXX:$(PAT)@XXX.visualstudio.com/XXX HEAD:master

或者先建立本地分支与远程master的跟踪关系（更稳定）：

# 拉取远程master分支到本地
git fetch origin master:master
git checkout master

# 执行代码运行、提交操作后推送
git push origin master

3. 修正路径问题（潜在隐患） #

你的git add ../csv/路径指向仓库目录外的文件，git无法追踪这类文件。建议将生成的csv文件放在仓库目录内，比如./csv/，修改命令为：

git add ./csv/

其他优化方案 #

方案一：启用持久化凭据避免手动输入PAT #

将checkout任务的persistCredentials设为true，流水线会自动使用内置凭据，无需手动拼接PAT URL：

- checkout: self
  persistCredentials: true
  clean: true
  displayName: Checkout and clean
  fetchDepth: 3
  fetchRefs: |
    refs/heads/master

推送时直接执行：

git push origin master

方案二：使用深度为1的超浅克隆（极致提速） #

如果只需要最新代码，将fetchDepth设为1，进一步减少克隆时间：

fetchDepth: 1

方案三：跳过重复清理步骤 #

流水线中先执行DeleteFiles@1清理所有文件，随后checkout任务又设置了clean: true，两步重复，可删除DeleteFiles@1步骤节省时间。

修改后的完整azure-pipeline.yml示例 #

jobs:
- job: Default
  timeoutInMinutes: 60
  pool:
    name: XXX
  workspace:
    clean: all 
  steps:
  - checkout: self
    persistCredentials: true
    clean: true
    displayName: Checkout and clean
    fetchDepth: 3 # 浅克隆保留最近3次提交
    fetchRefs: |
      refs/heads/master

  - task: CmdLine@2
    inputs:
      script: |
        uname -a
        python3 --version
        pip3 install -r requirements.txt
        echo check system
        git clean -d -f
        pwd
        ls -l
        
  - task: CmdLine@2
    inputs:
      script: |
        echo "Running code"
        python3 some_script.py

        git config --global user.email "XXX.com"
        git config --global user.name "XXX"

        # 确保csv目录在仓库内
        git add ./csv/
        git commit -m 'updated files'
        
        # 推送至远程master分支
        git push origin master        

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