如何在yq中使用Bash变量存储的值进行查询？

问题原因分析 #

1. 直接调用变量报错bash: task_auth: command not found：你直接输入$TASK_NAME时，Bash会将变量值task_auth当作系统命令执行，但该命令不存在，因此报错。查看变量值的正确方式是echo $TASK_NAME，你已经用对了。

2. yq查询返回null：如果你的yq表达式用单引号包裹（比如yq '.services.$TASK_NAME.environment.PORT' file.yml），Bash不会解析单引号内的变量，$TASK_NAME会被当作字符串字面量而非实际值task_auth，导致yq找不到对应键，返回null。

正确解决方案 #

根据你使用的yq版本，选择以下方法：

方法1：使用mikefarah/yq（v4及以上主流版本） #

方式A：双引号包裹表达式，让Bash解析变量

yq ".services.$TASK_NAME.environment.PORT" file.yml

此方法适合变量值无特殊字符的场景，Bash会先将$TASK_NAME替换为task_auth，再传递给yq执行。

方式B：通过yq环境变量引用（更可靠，支持特殊字符）

TASK_NAME=$TASK_NAME yq '.services[env(TASK_NAME)].environment.PORT' file.yml

将Bash变量注入yq的环境中，在yq表达式里用env(TASK_NAME)引用变量，避免Bash解析带来的问题。

方法2：使用kislyuk/yq（基于jq的版本） #

方式A：转义双引号包裹变量

yq ".services.\"$TASK_NAME\".environment.PORT" file.yml

方式B：用--arg传递变量

yq --arg task "$TASK_NAME" '.services[$task].environment.PORT' file.yml

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