接口返回一大坨 JSON,你只想拿到「价格大于 200 的商品名」。用浏览器一层层展开、用编辑器搜索都能凑合,可一旦嵌套两层,或者要按条件过滤,就得靠 jq 了。

jq 看着符号多,其实只有一条主线:先定位到数据,再筛掉不要的,最后拼成你要的形状。下面按这三步拆开讲,每一步都给能直接跑的例子。样例数据是一份商品数组:[{"id":1,"name":"键盘","price":299,"category":"hardware"}, ...]。

结论先行

  • 取某个字段:.user.address.city,点号往下走一层
  • 进数组:.[0] 取第几个,.[] 让每个元素都过一遍
  • 筛条件:.[] | select(.price > 200)
  • 拼输出:{name, price} 只留想要的字段
  • 比较不生效时,先看值是不是字符串,是就 tonumber

一、一条表达式就是「当前值 → 加工 → 结果」

jq 的表达式永远作用于「当前值」,. 就是当前值本身,所以 jq '.' data.json 等于原样输出这份 JSON。

管道 | 把左边的结果交给右边,右边拿到的东西成了新的「当前值」。后面所有写法,都是这一件事的叠加:

$ jq '.user.address.city' data.json
"杭州"

.user 先进入 user 对象,.address 再进一层,.city 取到值。层级有多少就点多少层,不用加引号。

键名里带空格、连字符或中文时,点号不认,改用方括号加引号:.["first-name"]、.["下单时间"]。

二、进数组:先定位到元素,再取字段

数组里的元素按位置取,从 0 开始:

$ jq '.[1].name' items.json
"鼠标"

.[1] 是「第二个元素」这一个值。想要每个元素都过一遍,把下标去掉:

$ jq '.[] | .name' items.json
"键盘"
"鼠标"
"显示器"
"会员"
"键盘"

输出行数等于数组元素个数,这是判断「有没有拆开」最快的办法。想「逐个处理但结果仍是一个数组」,用 map();想把所有值收进一个新数组,用中括号包起来:

$ jq '[.[].tag] | unique' items.json
["a","b","c"]

[.[].tag] 先把每个元素的 tag 收集成数组,unique 再去重。

嵌套两层时,[] 按从外到内的顺序写:.orders[] | .items[] | select(.price > 100) 先把订单拆开,再把每个订单里的商品拆开。顺序必须和数据的层级对应,跳过一层直接写,结果会是空的。

三、筛选:select 把不符合的整条丢掉

select(条件) 的规则很简单:条件为真就原样输出,为假就不输出。

$ jq '.[] | select(.price > 200)' items.json

五个商品里只留下价格大于 200 的三条。条件可以叠加,字符串相等用 ==:

$ jq '.[] | select(.category == "hardware" and .stock > 0)' items.json

这里有个新手最常踩的坑:select 放在哪,筛的就是谁。写成 .items | select(.price > 200),筛的是数组本身,数组没有 price,条件不成立,一条结果都没有;写成 .items[] | select(.price > 200),才是对每个元素判断。筛不出东西时,先回头数一下 [] 有没有漏。

四、拼成你要的形状:对象构造

筛完通常不想把整条记录都带走,只要几个字段。大括号按「键: 表达式」构造新对象,键名和取值表达式同名时可以缩写:

$ jq '.[0] | {id, name, price}' items.json
{"id":1,"name":"键盘","price":299}

{id, name, price} 等于 {"id": .id, "name": .name, "price": .price}。缩写不是魔法,就是省了重复写键名。

排序、分组也在这一层做,输出仍然是数组:

$ jq 'sort_by(.price) | .[] | {name, price}' items.json
$ jq 'group_by(.category) | map({category: .[0].category, count: length})' items.json

第一条按价格升序,第二条按分类分组数条数。两句都接在原来的表达式后面,改改字段名就能用到自己的数据上。

要把几个字段连成一句话,用 + 拼接,两侧都必须是字符串:

$ jq '.[0] | .name + " / " + .category' items.json
"键盘 / hardware"

有一侧是数字就会报错,先 tostring 再拼。这类表达式适合直接拿去生成文件名、日志行或者报表里的一列。

五、比较不生效,先怀疑类型

select(.price > 200) 什么都没筛出来,可价格明明都大于 200——多半是这些价格在 JSON 里被写成了字符串 "299",不是数字 299。jq 跨类型比较有固定的排序规则,不会按你想的数值大小来。

先确认,再转换:

$ jq '.user.ageText' data.json
"30"
$ jq '.user.ageText | tonumber' data.json
30

带引号的是字符串,tonumber 之后才是数字。反过来,数字要拼进字符串时用 tostring。拿不准时先用 .price | type 看一眼,输出 "string" 还是 "number",一眼就清楚了。这类问题不核对数据的实际类型,只盯着表达式改,是查不出来的。

六、写不出结果时,把管道切开看

jq 的表达式能一直接管道,出错时最难的是不知道断在哪一环。办法是做减法:从后往前删管道,只留前半段跑一次,看输出是不是你以为的样子。

  • 确认层级对不对:.user | keys,列出这个对象有哪些键
  • 确认拆开没有:.[] | .name,看结果是不是一行一个
  • 确认筛到了几条:.[] | select(...) | length

length 既能算数组元素个数,也能算对象键的个数,拿来当「这一环到底吐出了几条」的探针很好用。

最后

本地敲 jq 要先装环境,临时看一眼数据不值当。可以直接在 jq 在线查询 里贴 JSON、改表达式,边改边看结果;常写的表达式攒下来,也能对着 jq 速查 抄结构,再换成自己的字段名。