Azure Pipelines报"unexpected value 'name'"错误排查及多部署文件触发问题

1. 步骤非法字段 name #

Azure DevOps 的 Step 语法中不存在name属性，你在报错步骤里写的- name: Get the deployment file name是触发"unexpected value 'name'"错误的直接原因。直接删除这一行即可，步骤的显示名称已经由displayName定义。

2. 输出变量配置错误 #

你试图在步骤中定义outputs，但outputs是Job级别的属性，不能写在Step里。正确的输出变量配置方式如下：

• 给步骤添加id标识，用于后续引用输出
• 在Job的outputs中引用步骤的输出值

修改后的示例代码：

stages:
  - stage: Get_the_deployment_file_name  # Stage名称建议避免空格，用下划线/驼峰命名
    jobs:
      - job: Get_deployment_file
        displayName: 'Get deployment file'
        outputs:
          # 引用步骤id为set_deployment_file的输出变量
          deploymentFile: $[steps.set_deployment_file.outputs.deploymentFile]
        steps:
          # 去掉name字段，添加id用于输出引用
          - id: set_deployment_file
            script: |
              if [[ $BUILD_SOURCESDIRECTORY == *"deployment-folder"* ]]; then
                echo "##[set-output name=deploymentFile;]$(basename $BUILD_SOURCESDIRECTORY)"
              fi
            displayName: Get deployment file name
            env:
              SYSTEM_DEFAULTWORKINGDIRECTORY: $(System.DefaultWorkingDirectory)
              BUILD_SOURCESDIRECTORY: $(Build.SourcesDirectory)

          - script: echo "Deploying using test-hub-deploy-dev.yml"
            displayName: Deploy to test-dev
            condition: and(succeeded(), eq(variables['deploymentFile'], 'test-hub-deploy-dev.yml'))

3. 额外优化点 #

• Stage和Job的名称尽量避免空格，改用下划线或驼峰命名，减少潜在语法问题
• Bash脚本中优先使用env里定义的大写环境变量（如$BUILD_SOURCESDIRECTORY），更符合Shell语法规范

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