Azure Pipeline使用template时能否动态传递全部参数至extends？

云原生阿岚

2026-9-27

结论

你尝试的遍历方案是可行的，不存在参数作用域遮蔽的问题。

原理说明

在Azure DevOps YAML的编译时表达式${{ }}作用域中，parameters默认指向当前流水线根级定义的参数集合，不会被extends.parameters下的本地配置块覆盖，你担心的遮蔽问题不存在。

修正后的正确写法

你的代码只需要调整一个细节：编译时表达式里参数对象的属性是小写开头的name和value，不是大写开头，修正后代码如下：

parameters:
- name: Location
  type: string
  default: 'westus'
# 可新增任意根级参数，都会自动批量传递到模板
- name: Env
  type: string
  default: 'prod'

extends:
  template: Template.yml
  parameters:
    ${{ each param in parameters }}
      ${{ param.name }}: ${{ param.value }}

注意事项

该方案只会传递和模板参数同名的根级参数，如果根级参数在模板中没有定义，流水线运行时会抛出「未识别参数」的错误。如果你有多余的根级参数不想传递，可以在遍历的时候加过滤逻辑，示例如下：
```
extends:
  template: Template.yml
  parameters:
    ${{ each param in parameters }}
      ${{ if notIn(param.name, '不需要传递的参数1', '不需要传递的参数2') }}
        ${{ param.name }}: ${{ param.value }}
```
如果模板定义的必填参数没有在根级参数里声明，也会触发参数校验错误，需要提前保证两端参数的对齐。
你可以在模板中新增输出步骤验证参数传递效果，示例如下：
```
# Template.yml新增步骤
steps:
- script: echo "Location is ${{ parameters.Location }}, Env is ${{ parameters.Env }}"
```
运行后即可看到输出值和根级参数配置一致。