Azure DevOps流水线命令行脚本Git推送错误求助

一、error: src refspec main does not match any / error: pathspec 'main' did not match any file(s) known to git #

这类错误核心是本地不存在main分支，或分支下无任何提交内容，按以下步骤排查解决：

1. 先查看本地/远程全部分支，确认实际分支名称：

   git branch -a
   

   若远程默认分支是master而非main，后续命令替换为master即可。
2. 若本地无main分支，先创建并切换到该分支：

   git checkout -b main
   

3. 确保分支下有提交内容（空分支无法推送）：

   git add .
   git commit -m "Initial commit or update content"
   

4. 重新推送分支到远程：

   git push origin main
   

二、error: failed to push some refs #

该错误多伴随分支问题或权限不足，除按上述步骤确保分支存在且有提交外，补充操作：

• 推送前拉取远程分支最新内容，避免冲突：

  git pull origin main --rebase
  

• 确认流水线服务账号拥有仓库的推送权限（在Azure DevOps仓库设置的权限页面配置）。

三、终端提示禁用导致无法读取密码 #

Azure DevOps流水线禁止交互式密码输入，必须用非交互式认证方式，推荐两种方案：

1. 使用个人访问令牌（PAT）：
   生成带仓库读写权限的PAT，替换远程仓库地址的认证部分，也可将PAT存入流水线变量避免硬编码，或直接使用流水线内置令牌$(System.AccessToken)（需提前开启仓库权限）：

   git remote set-url origin https://$(System.AccessToken)@dev.azure.com/<组织名>/<项目名>/_git/<仓库名>
   

2. 使用流水线内置Checkout任务：
   先添加Checkout任务克隆仓库，后续命令行脚本直接在克隆好的目录中操作，流水线会自动处理认证与权限，无需手动配置。

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