如何用yq将YAML数组转为字符串以导出为环境变量

核心问题解决：用yq将YAML数组转为冒号分隔字符串 #

针对YAML数组无法直接转为字符串导出环境变量的问题，利用yq的join函数可直接将数组转为指定分隔符的字符串。示例命令：

# 处理example.yaml中的allowed_ips数组字段
yq e '.allowed_ips | join(":")' example.yaml

输出结果：192.168.1.1:10.0.0.0/24（对应YAML数组allowed_ips: [192.168.1.1, 10.0.0.0/24]）

Bash批量导出环境变量脚本 #

编写bash循环自动处理所有YAML字段，遇到数组自动转换，普通字段直接导出：

#!/bin/bash
# 从example.yaml读取所有键值对并导出为环境变量
while IFS="=" read -r key raw_value; do
    # 判断是否为数组格式（覆盖行内数组和多行数组）
    if echo "$raw_value" | grep -qE '^\[.*\]$|^- '; then
        # 用yq将数组转为冒号分隔字符串
        processed_value=$(yq e ".$key | join(\":\")" example.yaml)
    else
        processed_value="$raw_value"
    fi
    # 将键名转为大写（符合环境变量命名习惯，可按需调整）
    export $(echo "$key" | tr '[:lower:]' '[:upper:]')="$processed_value"
done < <(yq e 'to_entries | map("\(.key)=\(.value)") | .[]' example.yaml)

脚本说明 #

• yq e 'to_entries | map("\(.key)=\(.value)") | .[]'：将YAML结构转为key=value格式的行输出
• 正则匹配^\[.*\]$|^- ：兼容行内数组[]和多行缩进数组两种格式
• 最后将键名转为大写并导出为环境变量

适配Ansible/Bash/PHP的YAML规范 #

要保证YAML文件能被三个工具正确解析，必须遵循标准YAML语法，避免工具专属语法：

# 标准YAML示例，兼容所有三个工具
app_name: my_web_app
debug_mode: true
# 行内数组：适合简短列表
allowed_ips: [192.168.1.1, 10.0.0.0/24, 172.16.0.0/16]
# 多行数组：适合长列表，Ansible可读性更好
allowed_domains:
  - example.com
  - test.example.org
  - dev.local

各工具适配细节 #

• Ansible：直接用include_vars: example.yaml加载，数组可通过{{ allowed_ips | join(':') }}转为冒号分隔字符串
• PHP：用yaml_parse_file("example.yaml")解析为PHP数组，再通过implode(':', $yaml_data['allowed_ips'])转换为字符串，可按需用putenv导出为环境变量
• Bash：使用上述脚本即可自动处理数组转换并导出

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