如何在ADO模板中部分覆盖带默认值的对象类型参数？

你的需求是可行的，但ADO默认不会自动合并对象参数的默认值与传入的部分属性——直接传递部分对象会完全覆盖模板中的参数，导致原有默认属性丢失。要实现“仅覆盖指定属性、保留其余默认值”的效果，需要通过显式参数合并或拆分参数的方式处理。

为什么原方法失效 #

当你在project.yml中仅传递person: { role: "Teacher" }时，模板template.yml接收的person参数会被完全替换为这个仅含role的对象，原默认值first_name和last_name会被丢弃，自然无法解析。

解决方案一：使用union()函数合并参数 #

利用ADO的union()表达式函数，将默认对象与传入的部分属性合并，让传入的属性覆盖默认值，未传入的属性保留默认。

示例代码 #

project.yml（调用入口）

extends:
  template: main.yml
  parameters:
    personOverride:
      role: "Teacher"

main.yml（定义默认值并合并）

parameters:
  # 用于接收部分覆盖的属性
  - name: personOverride
    type: object
    default: {}
  # 定义完整的默认对象
  - name: defaultPerson
    type: object
    default:
      first_name: "Jane"
      last_name: "Doe"
      role: "Student"

# 合并后传递给模板
extends:
  template: template.yml
  parameters:
    person: ${{ union(parameters.defaultPerson, parameters.personOverride) }}

template.yml（接收合并后的完整对象）

parameters:
  - name: person
    type: object

steps:
  - script: echo "Name: ${{ parameters.person.first_name }} ${{ parameters.person.last_name }}, Role: ${{ parameters.person.role }}"

union()函数会将personOverride中的属性覆盖defaultPerson的对应属性，未传入的属性保留默认值，最终模板能获取完整的person对象。

解决方案二：拆分对象为独立参数 #

如果对象结构简单，可将对象的每个属性拆分为独立参数，这样就能单独覆盖某个属性，其余参数使用默认值。

示例代码 #

main.yml

parameters:
  - name: personFirstName
    type: string
    default: "Jane"
  - name: personLastName
    type: string
    default: "Doe"
  - name: personRole
    type: string
    default: "Student"

extends:
  template: template.yml
  parameters:
    personFirstName: ${{ parameters.personFirstName }}
    personLastName: ${{ parameters.personLastName }}
    personRole: ${{ parameters.personRole }}

project.yml

extends:
  template: main.yml
  parameters:
    personRole: "Teacher"

template.yml

parameters:
  - name: personFirstName
    type: string
  - name: personLastName
    type: string
  - name: personRole
    type: string

steps:
  - script: echo "Name: ${{ parameters.personFirstName }} ${{ parameters.personLastName }}, Role: ${{ parameters.personRole }}"

这种方式更直观，适合属性较少的对象。

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