如何在Shell脚本中向jq传递数量未知的参数？

我完全懂你被jq和shell引号折腾到崩溃的感觉！之前我也在写类似的脚本时踩过一模一样的坑——手动拼接jq命令字符串很容易因为shell的引号解析规则出问题，明明手动执行没问题，脚本里跑就报错。咱们一步步来解决这个问题：

错误根源分析 #

你遇到的jq: error: syntax error, unexpected INVALID_CHARACTER错误，本质是shell对引号的二次解析导致的：

• 你的assembleJQ函数用echo拼接了带单引号的jq命令字符串，比如生成jq -r -j '.data[] | .mac," ",.name,"\n"'
• 当你用$jq执行这个字符串时，shell会把整个字符串拆分成多个参数，原本的单引号会被当作普通字符处理，导致jq实际收到的是不完整的表达式（比如.data[]被单独作为一个参数，后面的| .mac...又变成另一个参数），自然编译失败。

正确实现方案：利用jq的$ARGS.positional动态接收参数 #

不需要手动拼接复杂的jq命令字符串，我们可以直接用jq的内置变量$ARGS.positional来接收bash传递的所有参数，动态提取任意数量的字段。这样完全避开shell引号的坑，代码更简洁可靠。

修改后的getDeviceKeys函数 #

把你原来的getDeviceKeys和相关拼接函数替换成下面的代码：

getDeviceKeys(){
    # 检查是否传入了字段参数
    if [ $# -eq 0 ]; then
        echo "Error: Please specify at least one device field (e.g., mac name ip)"
        return 1
    fi

    # 调用Unifi API，用jq动态处理任意数量的字段参数
    unifi_list_devices | jq -r -j --args '
        .data[] 
        | [$ARGS.positional[] as $key | .[$key]]  # 把所有指定字段收集成数组
        | join(" ")  # 用空格分隔字段（可以改成你想要的分隔符，比如","）
        + "\n"  # 每个设备占一行
    '
}

如何使用 #

现在你可以随意传递任意数量的字段参数，比如：

# 获取MAC和名称
./advancedapi.sh getDeviceKeys mac name

# 获取ID、IP、MAC、名称
./advancedapi.sh getDeviceKeys _id ip mac name

进阶：支持自定义分隔符 #

如果想要灵活指定字段之间的分隔符（比如逗号、分号），可以修改函数支持额外的分隔符参数：

getDeviceKeys(){
    if [ $# -eq 0 ]; then
        echo "Error: Please specify at least one device field (e.g., mac name ip)"
        return 1
    fi

    # 默认分隔符为空格，若最后一个参数是--separator=xxx则提取
    local separator=" "
    if [[ "${@: -1}" == --separator=* ]]; then
        separator="${@: -1#--separator=}"
        set -- "${@:1:$#-1}"  # 移除分隔符参数，剩下的都是字段名
    fi

    unifi_list_devices | jq -r -j --args --arg sep "$separator" '
        .data[] 
        | [$ARGS.positional[] as $key | .[$key]]
        | join($sep)
        + "\n"
    '
}

使用示例：

# 用逗号分隔MAC和名称
./advancedapi.sh getDeviceKeys mac name --separator=,

为什么这个方案更可靠 #

1. 避开shell引号陷阱：不需要手动拼接带引号的命令字符串，直接通过--args把bash参数传给jq，完全由jq处理字段名。
2. 原生支持任意数量参数：$ARGS.positional是jq专门用来接收命令行位置参数的数组，不管你传1个还是10个字段，都能正常处理。
3. 代码更易维护：逻辑清晰，不需要复杂的字符串拼接和计数逻辑，后期修改字段分隔符或处理逻辑都很方便。

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