Azure DevOps YAML模板传递Stage参数报错，如何实现可选阶段？

首先明确核心问题：Azure DevOps YAML模板不支持将Stage作为参数类型，这就是你遇到语法错误的根本原因。要实现固定Deploy阶段+可选自定义PreDeploy阶段的需求，得用符合模板语法规则的方式，以下是两种可行方案：

方案一：通过参数控制PreDeploy的启用与自定义步骤 #

这种方式让用户可以选择是否开启PreDeploy阶段，同时能传入自定义步骤：

基础模板（示例命名为base-deploy.yml） #

parameters:
  # 控制是否启用PreDeploy阶段
  enablePreDeploy: false
  # 允许用户传入PreDeploy的自定义步骤，默认空数组
  preDeploySteps: []

stages:
  - ${{ if eq(parameters.enablePreDeploy, true) }}:
    - stage: PreDeploy
      displayName: 预部署阶段
      jobs:
        - job: PreDeploy_Job
          steps:
            # 执行用户自定义步骤
            - ${{ parameters.preDeploySteps }}
            # 可选：模板自带的默认PreDeploy步骤（按需添加）
            # - script: echo "默认预部署操作"

  # 固定不可修改的Deploy阶段
  - stage: Deploy
    displayName: 部署阶段
    jobs:
      - job: Deploy_Job
        steps:
          - script: echo "固定部署操作，不可修改"

用户使用示例 #

需要自定义PreDeploy时：

extends:
  template: base-deploy.yml

parameters:
  enablePreDeploy: true
  preDeploySteps:
    - script: echo "用户自定义预部署步骤1"
    - task: PowerShell@2
      inputs:
        targetType: 'inline'
        script: |
          Write-Host "用户自定义PowerShell步骤"

不需要PreDeploy时直接省略相关参数：

extends:
  template: base-deploy.yml

方案二：通过模板片段注入完整PreDeploy阶段 #

如果用户需要完全自定义整个PreDeploy（包括jobs、变量等），可以让用户传入模板路径来引用：

基础模板 #

parameters:
  # 可选：用户自定义PreDeploy阶段的模板路径，默认不启用
  preDeployTemplate: ''

stages:
  - ${{ if ne(parameters.preDeployTemplate, '') }}:
    - template: ${{ parameters.preDeployTemplate }}

  - stage: Deploy
    displayName: 部署阶段
    jobs:
      - job: Deploy_Job
        steps:
          - script: echo "固定部署操作"

用户使用示例 #

先创建自定义的my-predeploy.yml：

stage: PreDeploy
displayName: 自定义预部署
jobs:
  - job: Custom_PreDeploy
    variables:
      customVar: 'test'
    steps:
      - script: echo "自定义预部署，变量值：$(customVar)"

再引用基础模板：

extends:
  template: base-deploy.yml

parameters:
  preDeployTemplate: my-predeploy.yml

补充说明 #

Azure DevOps的YAML参数仅支持基础类型（字符串、布尔、数字、数组、对象），不支持Stage、Job、Step这类复杂管道对象作为参数类型，这就是你之前尝试用Stage类型参数报错的原因。

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