Azure DevOps YAML构建管道运行时步骤被跳过致发布失败求助

你的构建管道任务被跳过、制品未生成的核心原因是YAML缩进错误，Azure DevOps的YAML解析器对层级结构要求严格，以下是具体问题和修复方案：

1. Job层级缩进错误 #

原YAML中steps被错误嵌套在pool节点下：

jobs:
 - job: Build
   displayName: Build
   pool:
    vmImage: $(vmImageName)
  
    steps:
    - task: UseDotNet@2
      ...

steps是job的直接子节点，应该和pool同级，而非嵌套在pool内。这个错误会导致Azure DevOps完全识别不到后续所有步骤，直接跳过执行。

2. ArchiveFiles任务输入项缩进错误 #

ArchiveFiles@2的inputs下的参数没有正确缩进：

- task: ArchiveFiles@2
  displayName: 'Archive files'
  inputs:
  rootFolderOrFile: '$(System.DefaultWorkingDirectory)/publish_output'
  ...

所有inputs的子参数需要缩进一级，否则参数不生效，归档任务无法生成正确的zip包。

修正后的完整YAML #

parameters:
 - name: buildConfig
   displayName: Build Configuration to Use
   default: Debug
   values:
    - Debug
    - Release

trigger:
  branches:
    include:
     - '*'
    exclude:
     - 'main'

variables:
  buildConfiguration: ${{ parameters.buildConfig }}
  azureSubscription: 'MyAzureSubscription'
  functionAppName: 'MyFunction'
  vmImageName: 'windows-latest'
  workingDirectory: '$(System.DefaultWorkingDirectory)/MySolution'
  testingDirectory: '$(System.DefaultWorkingDirectory)/MySolution.UnitTests'

stages:
  - stage: Build
    displayName: Build Stage
    jobs:
     - job: Build
       displayName: Build
       pool:
        vmImage: $(vmImageName)
       # 修正：steps与pool同级
       steps:
       - task: UseDotNet@2
         displayName: Setup Net Core 3.1.x
         inputs:
           packageType: 'sdk'
           version: '3.1.x'

       - task: DotNetCoreCLI@2
         displayName: Restore Nuget Packages
         inputs:
           command: restore
           projects: '**/*.csproj'
           feedsToUse: 'select'
           vstsFeed: 'xxxxxx'
           includeNuGetOrg: true

       - task: DotNetCoreCLI@2
         displayName: Build the Assembly
         inputs:
           command: 'build'
           projects: $(workingDirectory)/*.csproj
           arguments: '--output $(System.DefaultWorkingDirectory)/publish_output --configuration $(BuildConfiguration)'

       - task: DotNetCoreCLI@2
         displayName: Run Unit Tests
         inputs:
           command: 'test'
           projects: $(testingDirectory)/*.csproj
           enabled: false

       - task: ArchiveFiles@2
         displayName: 'Archive files'
         inputs:
           # 修正：所有输入项缩进一级
           rootFolderOrFile: '$(System.DefaultWorkingDirectory)/publish_output'
           includeRootFolder: false
           archiveType: zip
           archiveFile: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
           replaceExistingArchive: true

       - publish: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
         artifact: drop

为什么在线校验器未检测到问题？ #

多数在线YAML校验器仅检查基础语法（如冒号、列表格式），不会验证Azure DevOps管道特有的层级结构规则。Azure DevOps的YAML解析器会严格校验管道节点的父子关系，这种结构错误只会在管道初始化阶段被捕获。

后续排查建议 #

• 严格检查缩进：统一使用2或4空格缩进，不要混用空格和制表符，确保每个节点的子项层级正确。
• 查看管道初始化日志：运行管道后，先检查"Initialize job"阶段的日志，这里会输出YAML解析的错误或警告信息。
• 分步调试：先简化管道，只保留构建、归档、发布核心步骤，确认能生成制品后再逐步添加其他任务（如测试）。

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