Azure生成管道：如何正确定义并向构建模板传递多行变量

你之前配置不生效，是两个Azure管道的固有机制导致的：

• 普通全局变量做运行时代码替换时，多行字符串如果处理不当，会被合并成单行带空格的内容，而VSTest@2任务的testAssemblyVer2字段要求每一条匹配、排除规则必须单独占一行，单行拼接的内容会导致规则完全失效，排除项无法被识别
• 跨模板传递配置内容时，模板的编译解析优先级高于运行时变量替换，如果没有按照模板的参数传递规则传值，很容易出现变量没被正确读取、内容不完整的问题。

优先方案：用模板参数传递多行规则，不依赖全局变量 #

这是Azure官方推荐的跨模板传配置的标准写法，能从根源上避免换行丢失的问题：

1. 调整公共模板myTemplate.yaml，把测试项目匹配规则定义为模板入参：

   # myTemplate.yaml
   parameters:
   - name: testProjects
     type: string
     # 给个默认值，没传的时候就用原来的通用规则
     default: |
       **/*Unittest.csproj
       ! **/*Common.Unittest.csproj
   
   steps:
   - task: VSTest@2
     inputs:
       testSelector: 'testAssemblies'
       # 用模板参数语法直接读取入参，编译阶段就完成内容替换
       testAssemblyVer2: ${{ parameters.testProjects }}
   

2. 在父管道调用模板时，直接把自定义的多行规则作为参数传入，不需要把规则塞到全局variables块里：

   # my-azure-pipeline.yaml
   extends:
     template: myTemplate.yaml
     parameters:
       testProjects: |
         **/FirstUnittestProject.csproj
         ! **/SecondUnittestProject.csproj
         ! **/*Common.Unittest.csproj
   

   这种写法下，多行内容的换行、缩进、排除规则都会在管道编译阶段完整解析，VSTest任务能正确识别每一条规则，不会出现格式错乱的问题。

兜底方案：如果坚持用全局变量传值，需要注意两个细节 #

如果不想调整模板的参数结构，一定要用全局变量传递配置，需要避免几个常见的坑：

• 全局变量必须定义在管道最开头的variables块中，要在extends模板引用的前面定义，否则模板编译时无法读取到变量内容
• 不要把这个变量设置成“队列构建时可配置”的变量——这类变量在传值时会强制把换行替换成空格，直接破坏多行规则的格式
• 可以在VSTest任务前加个调试脚本，打印变量的实际内容，确认格式没有错乱：

  - script: |
      echo "==== 实际测试项目规则 ===="
      echo "$(testProjects)"
    displayName: '调试匹配规则'
  

  检查输出内容是否每一条规则单独占一行，!排除符和后面的路径之间有没有多余的空格，这些细节问题都会导致排除规则失效。

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