Azure Pipeline：if表达式内动态渲染表达式失效问题排查

问题背景 #

你在搭建前端单仓构建流水线时，想要实现任务间的依赖关系：先定义需要发布的库列表，再为每个库指定依赖项，让依赖的库先完成构建发布，再执行当前库的任务。

你定义的参数如下：

parameters:
  - name: librariesToBePublished
    default:
      - my-awesome-package-1
      - my-awesome-package-2
      - my-awesome-package-3
    type: object

  - name: dependencies_my_awesome_package_2
    displayName: "Library dependencies of my-awesome-package-2"
    default:
      - my-awesome-package-1
    type: object

  - name: dependencies_my_awesome_package_3
    displayName: "Library dependencies of my-awesome-package-3"
    default:
      - my-awesome-package-1
      - my-awesome-package-2
    type: object

然后编写了任务定义，尝试通过循环生成构建任务并自动设置依赖：

- stage: Publish
    displayName: "Publish Libraries"
    jobs:
      - ${{ each package in parameters.librariesToBePublished }}:
          - job: Build_${{replace(package, '-', '_')}} 
            displayName: "Build ${{package}}"
            ${{ if parameters['${{ format('dependencies_{0}', replace(package, '-', '_')) }}'] }}:
              dependsOn:
                - ${{ each dep in parameters['${{ format('dependencies_{0}', replace(package, '-', '_')) }}'] }}:
                  - Build_${{replace(dep, '-', '_')}} 
            condition: succeeded()

但发现echo $[parameters['${{format('libDependencies_{0}', replace(package, '-', '_') ) }}']能正常输出，但if和each语句块里的表达式完全不生效。

问题根源 #

核心问题是模板表达式不能嵌套使用。

Azure DevOps里的${{ }}是编译时模板表达式，用于在流水线启动前生成最终的流水线结构；而$[...]是运行时表达式，在流水线执行过程中动态取值。

你在if和each里写的${{ parameters['${{ format(...) }}'] }}属于嵌套了两层${{ }}，编译时解析器无法正确识别这种写法，直接导致表达式失效。而echo里的写法是把编译时表达式嵌入到运行时表达式中，运行时能正确解析，所以可以正常工作，但这种方式不适用于编译时的模板逻辑（if/each）。

解决方案 #

去掉模板表达式的嵌套，直接在${{ }}块内调用format函数即可，因为整个${{ }}上下文已经是模板表达式环境，不需要再嵌套一层：

修正后的任务代码如下：

- stage: Publish
    displayName: "Publish Libraries"
    jobs:
      - ${{ each package in parameters.librariesToBePublished }}:
          - job: Build_${{replace(package, '-', '_')}} 
            displayName: "Build ${{package}}"
            # 直接在参数索引中使用format函数，无需嵌套${{ }}
            ${{ if parameters[format('dependencies_{0}', replace(package, '-', '_'))] }}:
              dependsOn:
                ${{ each dep in parameters[format('dependencies_{0}', replace(package, '-', '_'))] }}:
                  - Build_${{replace(dep, '-', '_')}} 
            condition: succeeded()

关键说明 #

• 编译时模板表达式（${{ }}）用于流水线结构的动态生成，比如循环创建job、条件判断是否生成某个任务，这些逻辑必须在流水线启动前确定。
• 运行时表达式（$[...]）用于执行过程中动态获取值，比如输出参数、环境变量，但不能用来控制流水线的结构。
• 模板表达式内部可以直接调用内置函数（如format、replace），不需要额外嵌套${{ }}。

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