Azure DevOps Pipelines跨阶段步骤共享自定义变量实现方法

你遇到的dependencies/stageDependencies识别报错、变量读取失败问题，由三个配置错误直接导致：

• 上游ChangedFiles@1任务生成的变量默认是作业内局部变量，没有标记为可跨作业/跨阶段传递的输出变量，下游阶段默认无法访问
• stageDependencies语法本身支持在步骤级condition中直接调用，你之前读取失败除了变量未做输出标记，还存在第二个测试任务条件里重复嵌套引用路径的书写错误
• 跨阶段引用时变量名大小写、路径层级没有和上游配置匹配，导致取值失败

修正步骤 #

1. 配置上游阶段的输出变量 #

跨阶段传递变量的核心前提是：上游生成变量的步骤必须配置固定name标识，且变量被标记为输出类型。修正后的BuildAndUnit阶段配置如下：

stages:
  - stage: BuildAndUnit
    jobs:
    - job: Build
      steps:
      - task: touchify.vsts-changed-files.vsts-changed-files.ChangedFiles@1
        name: ChangedFiles # 必须给步骤设置唯一name，下游引用依赖该值
        displayName: 'Detect Changes'
        inputs:
          rules: |
            [RunBackendTests]
            !+(WebUi|Web2)/**
            [RunNgWebAppTests]
            Web2/*
            Web2/!(administration)/**
            [RunNgWebAdminTests]
            Web2/package.json
            Web2/package-lock.json
            Web2/administration/**
          outputVariable: ChangedFiles # 显式开启任务输出变量，允许跨作业访问

注意：ChangedFiles@1任务会自动将规则中定义的变量名转为全小写输出，例如RunNgWebAppTests对应实际输出变量名为runngwebapptests，下游引用时名称必须完全匹配。

2. 修正下游阶段的变量引用逻辑 #

你原配置中第二个Npm任务的条件存在重复嵌套的路径书写错误，同时可以先在作业级将上游输出变量映射为本地短变量，既简化步骤里的引用写法，也满足“所有步骤正常加载、仅按变量值判断是否执行”的需求。修正后的CoreTests阶段配置如下：

- stage: CoreTests
    displayName: 'Core Tests'
    dependsOn: BuildAndUnit # 必须显式声明对上游阶段的依赖，否则无法读取其输出
    jobs:
    - job: CoreTest
      # 作业级统一映射上游输出变量，步骤内可直接通过variables[]调用
      variables:
        RunNgWebAppTests: $[ stageDependencies.BuildAndUnit.Build.outputs['ChangedFiles.runngwebapptests'] ]
        RunNgWebAdminTests: $[ stageDependencies.BuildAndUnit.Build.outputs['ChangedFiles.runngwebadmintests'] ]
        RunBackendTests: $[ stageDependencies.BuildAndUnit.Build.outputs['ChangedFiles.runbackendtests'] ]
      steps:
      - checkout: none
      - task: Npm@1
        displayName: 'Ng WebApp Unit Test'
        inputs:
          command: custom
          customCommand: ''
        condition: and(succeeded(), eq(variables['RunNgWebAppTests'], 'true'))
      - task: Npm@1
        displayName: 'Run Ng WebAdmin Unit Tests'
        inputs:
          command: custom
          customCommand: ''
        condition: and(succeeded(), eq(variables['RunNgWebAdminTests'], 'true'))

关键说明 #

• 跨阶段/跨作业传递变量时，上游生成变量的步骤必须配置name属性，普通步骤内的局部变量不会自动同步到下游
• stageDependencies语法无层级限制，可直接在阶段、作业、步骤的条件判断、变量定义中使用，不存在“仅能在作业/阶段层级调用”的限制
• 上述作业级变量映射的方案完全适配你的业务场景：如果上游未给对应变量赋值，变量默认值为空字符串，对应步骤的条件判断为false时会自动跳过，不会影响其他步骤的加载和运行，不需要在阶段或作业级设置全局执行条件
• 跨阶段引用输出变量的固定格式为stageDependencies.<上游阶段名>.<上游作业名>.outputs['<步骤name>.<变量名>']，书写时不要嵌套重复路径。

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