如何在jq中使用if条件验证字段并设置默认值

简洁方案：用//操作符处理空值 #

jq里的//操作符专门用来处理"空值"场景（包括字段为null、字段不存在的情况），写法比if条件更简洁：

• 仅读取字段值（返回默认值如果是null/不存在）：

jq -r '.timeout // 300' file.json

原JSON的timeout是100就返回100，如果是null或者没有这个字段，就返回300。

• 修改整个JSON，将null/不存在的字段替换为默认值：

jq '.timeout = .timeout // 300' file.json

执行后会输出完整的JSON，timeout字段会被替换为默认值（如果原字段是null或不存在），否则保持原值。

用if条件实现验证逻辑 #

如果一定要用if条件来实现，写法如下：

仅判断字段为null的情况

jq 'if .timeout == null then .timeout = 300 else . end' file.json

这个命令会检查timeout字段是否为null，是的话就赋值为300，否则保持原JSON内容不变。

同时处理字段不存在的情况

如果你的JSON可能存在timeout字段缺失的情况，可以用not覆盖更全面的"空"场景：

jq 'if (.timeout | not) then .timeout = 300 else . end' file.json

这里(.timeout | not)会把null、false以及字段不存在的情况都判定为true，统一设置默认值。

测试示例 #

比如你的JSON是：

{  
    "timeout": null
}

执行上述命令后，输出会变成：

{
  "timeout": 300
}

如果原JSON的timeout是100，执行后输出和原JSON一致。

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