Azure Pipeline如何跨阶段传递变量并传入部署模板参数

核心原因 #

你遇到的是Azure DevOps编译时变量和运行时变量的求值时机差异问题，你在Build阶段输出的pkgversion是运行时生成的变量，而你尝试的大部分写法都是编译时求值，自然无法拿到有效值。

正确配置步骤 #

1. 确认调用模板时的参数写法 #

你写的$[stageDependencies.Build.Build.outputs['packageversion.pkgversion']]本身是正确的运行时跨阶段变量引用语法，不需要改这部分。

2. 修正模板内的参数调用方式 #

这是最常见的踩坑点：你的模板里不能用编译时表达式${{ parameters.packageVersion }}来读取这个参数，必须用运行时变量语法$(packageVersion)调用。
示例模板正确写法：

# path/to/deploy/template.yml@global-templates
parameters:
- name: dependsOn
  type: object
  default: []
- name: template
  type: string
- name: packageVersion
  type: string

stages:
- stage: DeployCDN
  dependsOn: ${{ parameters.dependsOn }}
  jobs:
  - job: Deploy
    steps:
    # 错误写法（编译时求值，拿不到运行时生成的版本号）：
    # - script: echo ${{ parameters.packageVersion }}
    # 正确写法（运行时求值）：
    - script: echo $(packageVersion)
      displayName: 打印部署版本号
    # 后续CDN部署任务直接用$(packageVersion)即可

3. 排查变量生成有效性 #

如果改完模板还是拿不到值，先加一个测试阶段验证变量本身是否正确输出：

# 放在Build阶段之后，模板调用之前
- stage: TestOutputVar
  dependsOn: Build
  jobs:
  - job: PrintPkgVersion
    steps:
    - script: echo "输出版本号：$[stageDependencies.Build.Build.outputs['packageversion.pkgversion']]"
      displayName: 验证跨阶段变量

如果这个测试阶段输出版本号为空，检查两个点：

• CmdLine任务的工作目录是否和package.json所在目录一致，require('./package.json')的路径是否正确
• 阶段名、Job名、任务名、输出变量名的大小写是否完全匹配，Azure DevOps变量引用大小写敏感

其他写法错误说明 #

你之前尝试的其他写法都不符合跨阶段运行时变量的引用规则：

• ${{ pkgversion }} / ${{ variables.pkgversion }}：编译时求值，此时Build阶段还未执行，变量不存在
• $(pkgversion) / $(variables.pkgversion)：仅能读取当前阶段的变量，无法读取上游阶段的输出变量

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