jq转换文件内容为JSON字符串在命令替换场景下失效

问题成因 #

该问题是Amazon Linux 2环境下shell执行上下文差异导致的典型问题，核心原因按发生概率从高到低排序如下：

• Shell别名展开规则差异
  Amazon Linux 2默认的Bash配置中，交互式终端运行时会自动加载~/.bashrc等配置文件中的自定义别名，但是命令替换$()所属的非交互式执行上下文默认不会展开别名。
  如果你此前给jq设置了带额外参数的别名（例如alias jq='jq -C'这类强制输出颜色的配置，或是误配置的别名规则），直接在终端执行命令时别名自动补全参数，jq可以正常运行；但放到$()中时别名不生效，jq接收到的参数不符合预期，就会输出帮助信息并退出，最终帮助内容被存入了变量。
• 变量打印时的Shell通配符展开
  如果你打印变量时使用的是echo $MY_VARIABLE而非带引号的echo "$MY_VARIABLE"，变量中包含的*通配符会被Shell自动展开为当前工作目录下的文件名列表。如果当前目录下存在名为-h、--help这类匹配jq帮助参数的文件，且你误将变量值作为命令直接执行（例如直接输入$MY_VARIABLE回车而非用echo打印），就会触发jq的帮助输出。
• PATH环境变量差异
  命令替换的执行上下文继承的PATH可能和交互式终端的PATH不同，如果PATH中存在优先级更高的同名jq自定义脚本（而非官方jq二进制文件），该脚本的参数处理逻辑和官方jq不一致，也会导致参数识别错误，输出帮助信息。

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