Azure DevOps流水线中以对象类型传递环境变量的实现问询

你的期望写法其实是完全可行的，Azure DevOps支持将对象类型的参数直接展开到env块中，且能和额外的环境变量共存。下面是完整的实现方案：

1. 定义作业模板（接收对象类型的环境变量参数） #

# templates/my-job-template.yml
parameters:
  - name: envVars
    type: object
    default: { DEFAULT_ENV: "default_value" }

jobs:
- job: BuildJob
  steps:
  - script: |
      echo "DEFAULT_ENV: $DEFAULT_ENV"
      echo "CUSTOM_ENV: $CUSTOM_ENV"
      echo "EXTRA_ENV: $EXTRA_ENV"
    env:
      ${{ parameters.envVars }}  # 展开传入的环境变量对象
      EXTRA_ENV: "extra_fixed_value"  # 额外添加的环境变量

2. 调用模板时传递环境变量对象 #

在主流水线中调用模板时，直接传递键值对形式的对象即可：

# azure-pipelines.yml
trigger: none

extends:
  template: templates/my-job-template.yml
  parameters:
    envVars:
      CUSTOM_ENV: "custom_value_from_pipeline"
      ANOTHER_ENV: "another_custom_value"

3. 实际展开效果 #

Azure DevOps运行时会将${{ parameters.envVars }}展开为对应的键值对，最终等效于：

env:
  CUSTOM_ENV: "custom_value_from_pipeline"
  ANOTHER_ENV: "another_custom_value"
  EXTRA_ENV: "extra_fixed_value"

4. 关键注意事项 #

• 环境变量的键必须符合系统命名规范（通常为大写字母+下划线，避免特殊字符）。
• 如果需要传递动态值（比如来自变量组、流水线变量），可以在参数中直接引用：

  parameters:
    envVars:
      DYNAMIC_ENV: ${{ variables.MyPipelineVar }}
      GROUP_ENV: ${{ variables.MyVariableGroupVar }}
  

• 如果需要传递空对象，将default设为{}即可，避免默认值带来的干扰。

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