如何用jq实现JSON数组对象的新增与存在时覆盖

你这个需求其实不用手动写循环遍历，jq提供了更优雅的方式来实现「存在则覆盖value，不存在则新增元素」的逻辑——核心思路是把数组转换成以name为键的对象，合并新元素后再转回数组，这样能一次性处理两种场景。

核心jq实现逻辑 #

方法1：使用INDEX函数（jq 1.6+推荐） #

jq 1.6及以上版本提供了INDEX函数，可以快速将数组转换为以指定字段为键的对象。结合对象合并操作，就能轻松实现需求：

# 示例：覆盖item2的value为false，同时新增item3的value为true
jq '.objectList = (.objectList | INDEX(.name) + {"item2": {"name": "item2", "value": false}, "item3": {"name": "item3", "value": true}} | values)' apiResponse.json

逻辑拆解：

1. INDEX(.objectList[]; .name)：把objectList数组转成以name为键的对象，格式类似{"item1": {"name":"item1", "value":false}, ...}
2. + {...}：合并新的元素对象——如果键已存在则覆盖值，不存在则新增键值对
3. values：把对象的所有值提取出来，重新组成数组
4. 最后将处理后的数组赋值回.objectList

方法2：兼容低版本jq（无INDEX函数） #

如果你的jq版本低于1.6，可以用reduce手动构建键值对象：

jq '.objectList = (reduce .objectList[] as $item ({}; .[$item.name] = $item) | .["item2"] = {"name": "item2", "value": false} | .["item3"] = {"name": "item3", "value": true} | values)' apiResponse.json

结合Bash脚本实现参数化调用 #

要在bash脚本中接受name和value参数，需要用jq的--arg（传递字符串）和--argjson（传递布尔值）选项，动态注入参数：

#!/bin/bash

# 检查参数数量
if [ $# -ne 2 ]; then
    echo "用法: $0 <元素名称> <true/false>"
    exit 1
fi

ITEM_NAME="$1"
ITEM_VALUE="$2"

# 用jq处理JSON文件，支持覆盖或新增元素
jq --arg name "$ITEM_NAME" --argjson value "$ITEM_VALUE" '
    .objectList = (
        .objectList 
        | INDEX(.name)  # 低版本jq替换成：reduce .[] as $item ({}; .[$item.name] = $item)
        | + {($name): {"name": $name, "value": $value}} 
        | values
    )
' apiResponse.json

脚本使用示例 #

假设原apiResponse.json内容为：

{ "objectList": [ { "name": "item1", "value": false }, { "name": "item2", "value": true } ] }

• 覆盖已存在元素：

  ./update_json.sh item2 false
  

  输出结果：

  {
    "objectList": [
      {
        "name": "item1",
        "value": false
      },
      {
        "name": "item2",
        "value": false
      }
    ]
  }
  

• 新增不存在元素：

  ./update_json.sh item3 true
  

  输出结果：

  {
    "objectList": [
      {
        "name": "item1",
        "value": false
      },
      {
        "name": "item2",
        "value": true
      },
      {
        "name": "item3",
        "value": true
      }
    ]
  }
  

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