Azure Pipeline模板读取变量时值损坏，如何让变量按字面量处理

根因说明 #

变量值损坏的核心原因是Azure Pipeline的$(变量名)宏语法在解析阶段会自动识别字符串内的$开头字符为待替换的管道变量引用。你传入的默认值3q4w#V$X3q4w#V$X中的$X会被识别为名为X的管道变量，因该变量不存在就会被替换为空值，最终得到损坏后的3q4w#V#V结果。

可行解决方案 #

方案1：通过环境变量读取（最推荐，适配所有场景包括Key Vault密钥） #

Azure Pipeline会自动将所有定义的变量注入为执行脚本的环境变量，直接读取环境变量可完全跳过宏语法的解析逻辑，无需修改原变量值：
修改子模板child_scott_one.yaml的script代码块，变量名统一使用全大写的环境变量格式：

steps:
- script: |
    echo "here is big_var_01  -->$BIG_VAR_01<-- "
    local_var_01=$BIG_VAR_01
    echo
    echo "here is local_var_01  -->$local_var_01<-- "
    echo
    echo "length of local_var_01 is ${#local_var_01}"
    echo
  name: DetermineResult

该方案同时适配Key Vault读取的敏感值，无需修改密钥存储内容。

方案2：转义$字符 #

如果必须使用$(变量名)宏语法，可对变量值中的$做转义处理，Azure Pipeline会将$$解析为字面量$：

• 手动定义参数时，直接修改默认值的$为$$：

  parameters:
    - name: big_var_01
      displayName: "this var wants to get written to then read by templates"
      type: string
      default: '3q4w#V$$X3q4w#V$$X'
  

• 动态读取的变量（包括Key Vault密钥）可通过表达式自动转义：

  variables:
  - name: big_var_01
    value: ${{ replace(parameters.big_var_01, '$', '$$') }}
  

方案3：显式传递模板参数+模板表达式读取 #

将变量作为模板参数显式传递，使用${{ 参数名 }}模板表达式在编译阶段直接注入字面量，不会触发后续宏替换：

1. 修改父流水线parent_scott.yaml的模板调用逻辑，传入参数：

   stages:
   - template: child_scott_one.yaml
     parameters:
       big_var_01: ${{ parameters.big_var_01 }}
   

2. 修改子模板child_scott_one.yaml，声明接收参数并用模板表达式读取：

   parameters:
     - name: big_var_01
       type: string
   stages:
   - stage: A
     jobs:
     - job: JA
       steps:
       - script: |
           echo "here is big_var_01  -->${{ parameters.big_var_01 }}<-- "
           local_var_01=${{ parameters.big_var_01 }}
           echo
           echo "here is local_var_01  -->$local_var_01<-- "
           echo
           echo "length of local_var_01 is ${#local_var_01}"
           echo
         name: DetermineResult
   

内容的提问来源于stack exchange，提问作者John Scott Stensland