Azure DevOps YAML管道构建报错：‘A sequence was not expected’求助

这种卡在第一行的YAML解析错误确实让人抓狂——毕竟你已经试过从完全空白的文件到官方模板的各种配置，结果都报同样的错，说明问题肯定不在YAML内容本身，得从管道关联、文件本身或者系统配置这些方向排查：

1. 先确认管道读取的是正确的文件 #

• 检查管道绑定的仓库和分支：进入管道编辑页面，看顶部的"Repository"和"Branch"是不是你提交yml文件的那个仓库分支，有没有误选成其他仓库的同名分支（内容可能不符合YAML规范）。
• 确认yml文件的位置：Azure DevOps默认找仓库根目录下的azure-pipelines.yml，如果你的文件放在子文件夹里，需要在管道设置里指定路径——进入管道的"Triggers"设置（右上角"..."菜单里），在YAML标签页检查"Path to YAML file"是否正确。

2. 排查文件编码和隐藏字符问题 #

YAML解析对文件开头的字符非常敏感，哪怕一个看不见的隐藏字符都会导致报错：

• 用VS Code打开本地的yml文件，开启"显示控制字符"功能（左下角编码旁边的菜单，选"显示控制字符"），看看第一行开头有没有�或者其他奇怪的符号；
• 将文件转成UTF-8无BOM格式再提交：VS Code里可以通过右下角的编码选项，选择"通过编码保存"->"UTF-8"；
• 尝试直接在Azure DevOps网页端的仓库里编辑azure-pipelines.yml，写个最简单的配置（比如下面这段），然后保存触发构建，排除本地文件上传时的编码问题：

  trigger:
  - master
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: echo Test
  

3. 检查管道的自定义配置 #

• 如果是手动创建的管道，有没有在设置时指定了错误的YAML路径？或者中途修改过管道的源文件路径？重新进入管道编辑页，确认YAML源的路径无误。
• 尝试创建一个全新的管道：选择你的仓库，直接用默认的"Starter Pipeline"保存运行，如果新管道能正常执行，说明旧管道的配置有异常，对比两个管道的设置找差异。

4. 排查代理和服务端的临时问题 #

• 如果你用的是自托管代理，试试切换到微软托管的代理池（比如ubuntu-latest），排除代理环境的干扰；
• 手动触发构建时，勾选"禁用缓存"选项（如果有），避免缓存的旧配置导致解析错误；
• 重启自托管代理，或者等待一段时间再试，有时候Azure DevOps服务端的临时缓存会引发奇怪的解析问题。

5. 验证权限设置 #

• 确认Azure Pipelines的服务账号有读取仓库的权限：进入仓库的"Settings"->"Permissions"，搜索"Azure Pipelines"，确保它有"Read"权限，没有的话添加权限再试。

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