Pipeline中YAML数组转环境变量报错：含空格元素不被识别

问题重现 #

你在Pipeline中定义了如下YAML变量：

IP_ADDRESS: "https://158.92.126.23" 
ARRAY_OF_STRINGS:
  - "String1 String2"
  - String3

尝试用以下命令提取为环境变量时：

eval $(echo "$ARRAY_OF_STRINGS" | yq -r 'to_entries | .[] | "export \(.key)=\"\(.value)\""')

出现报错：

/scripts-386544-265099164/step_script: line 255: export: `String2,String3]': not a valid identifier

错误原因 #

原命令的核心问题：

1. YAML数组直接转为字符串时会变成[String1 String2,String3]，第一个元素的空格会被eval当成命令参数分隔符
2. 未对带空格的字符串做转义，导致export错误识别非法的环境变量名，触发报错

解决方案 #

利用yq的@sh转义函数处理特殊字符，并针对数组生成符合Bash语法的定义格式：

完整执行命令 #

假设YAML内容存储在$YAML_CONTENT变量中，执行以下命令：

eval $(yq -r '
  to_entries | .[] | 
  if .value | type == "array" then
    "export \(.key)=(" + (.value | map(@sh) | join(" ")) + ")"
  else
    "export \(.key)=\(.value | @sh)"
  end
' <<< "$YAML_CONTENT")

关键逻辑说明 #

• @sh：自动为带空格、特殊字符的字符串添加正确引号，确保eval解析时不会拆分内容
• 数组处理：将数组每个元素用@sh转义后拼接，包裹在()中，生成Bash标准数组格式export ARRAY_OF_STRINGS=("String1 String2" "String3")
• 标量处理：对单个值变量（如IP_ADDRESS）直接用@sh转义，避免特殊字符引发的解析问题

验证效果 #

执行命令后，可通过以下命令验证结果：

# 输出单个变量值
echo "$IP_ADDRESS"
# 输出数组第一个带空格的完整元素
echo "${ARRAY_OF_STRINGS[0]}"
# 遍历数组所有元素
for item in "${ARRAY_OF_STRINGS[@]}"; do echo "$item"; done

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