jq提取字段首选.key，但需用select(.!=null)或//处理null；数组遍历用.arr[]；过滤用select()配合has()判存在；格式化用-r和@csv等避免手动字符串处理。
提取单个字段值：用 .key 最直接，但注意 null 和缺失字段的区别
当你执行 jq '.name' data.json，如果 JSON 中没有 name 字段，jq 默认输出 null，而不是报错或跳过。这容易在管道后续处理中引发意外（比如传给 grep 或 awk 时多出一行 null）。
更稳妥的做法是用 select 过滤掉空值：jq -r '.name | select(. != null)' data.json；或者用 // 提供默认值：jq -r '.name // "unknown"' data.json。
-
-r参数必须加，否则字符串带引号，后续 shell 处理会出问题 - 字段名含连字符（如
user-id）要写成."user-id"，不能直接点 - 嵌套对象如
{"user": {"profile": {"age": 30}}}，取值写.user.profile.age，中间任何一层为null整体就返回null
遍历数组：用 [] 和 .[] 区分“整个数组”和“每个元素”
常见错误是把 .items 当作数组本身来遍历，结果只输出一次数组结构。真正逐项处理要用 .items[].name —— 后面的 .[] 才是“展开数组”的关键操作符。
例如 JSON 是 {"results": [{"id":1,"v":true}, {"id":2,"v":false}]}：
-
jq '.results' file.json→ 输出整个数组[{"id":1,"v":true},...] -
jq '.results[].id' file.json→ 输出两行：1 和 2 -
jq '.results[] | select(.v == true) | .id' file.json→ 只输出满足条件的id（这里是 1）
注意：.[] 对非数组输入（比如对象或字符串）会报错，加 ? 可静默忽略：.items[].name?。
过滤与条件判断：select() 是核心，但别忘了它只保留“真值”，不是布尔转换
select(.status == "active") 看似简单，但实际行为取决于 .status 类型：如果是字符串，匹配成功；如果是 null 或缺失字段，整个表达式为 false，该条目被丢弃；如果是数字 1，跟字符串 "active" 比较永远为 false —— jq 不自动类型转换。
- 多个条件用
and/or：select(.age > 18 and .city == "Beijing") - 检查字段是否存在：
select(has("email"))比select(.email != null)更准确（后者在"email": null时仍为true） - 正则匹配用
test()：select(.name | test("^A.*"))
误用 select 最常见的坑是：想“排除 null”，却写了 select(.field != null)，结果 .field 根本不存在时也返回 null，导致逻辑失效。
格式化与组合输出：用 {} 和 [] 构造新结构，避免拼接字符串
不要用 jq '.name' file.json | sed 's/"//g' 去掉引号，而应直接用 -r + 构造对象。比如想输出 id:name 格式：
jq -r '.results[] | "\(.id):\(.name)"' file.json
更规范的做法是先构造对象再转字符串：
jq -r '.results[] | {id, name} | join(":")' file.json
-
join()只对数组有效，所以得先用[.id, .name]包裹 - 构造对象
{a: .x, b: .y}比{x, y}更明确，尤其字段名不一致时 - 输出纯 CSV 且含逗号/换行等特殊字符？jq 本身不转义，建议用
@csv：jq -r '[.id, .name] | @csv'
复杂点在于嵌套结构扁平化：比如 .tags 是字符串数组，想每条记录输出多行 tag，得用 .tags[] 展开后再组合，这里容易漏掉层级或重复 .[]。
