Azure DevOps YAML含特殊字符模板参数的Bash相等校验语法问题

方法1：用printf安全传递参数 #

通过printf的%q格式符自动转义特殊字符，将参数值安全写入变量，避免破坏Bash语法结构：

parameters:
  - name: strValue

steps:
- task: Bash@3
  displayName: 'Do stuff'
  inputs:
    targetType: inline
    script: |
      # 用%q转义所有特殊字符后赋值
      input_value=$(printf '%q' "${{ parameters.strValue }}")
      if [ "$input_value" == "valueX" ]; then
          echo "参数值匹配valueX"
          # 执行后续业务逻辑
      else
          echo "参数值不匹配valueX"
      fi

方法2：通过流水线变量中转传递 #

将参数赋值为流水线变量，再映射为Bash环境变量，Azure DevOps会自动处理变量的转义逻辑：

parameters:
  - name: strValue

variables:
  - name: pipelineStr
    value: ${{ parameters.strValue }}

steps:
- task: Bash@3
  displayName: 'Do stuff'
  inputs:
    targetType: inline
    script: |
      if [ "$PIPELINE_STR" == "valueX" ]; then
          echo "参数值匹配valueX"
          # 执行后续业务逻辑
      else
          echo "参数值不匹配valueX"
      fi
  env:
    # 将流水线变量映射为Bash环境变量
    PIPELINE_STR: $(pipelineStr)

问题根源说明 #

原代码直接用${{ parameters.strValue }}嵌入脚本，当参数包含单引号、双引号、换行符时，会直接破坏Bash的语法结构（比如参数中的双引号会提前闭合脚本里的引号）。上述两种方法通过转义或Azure内置的变量传递机制，确保特殊字符被正确处理，避免语法错误。

内容的提问来源于stack exchange，提问作者benjamin.keen