本文轉(zhuǎn)載自微信公眾號「涼涼的知識庫」，作者涼涼的知識庫。轉(zhuǎn)載本文請聯(lián)系涼涼的知識庫公眾號。
jq是一個(gè)靈活的輕量級命令行JSON處理器，你可以使用jq命令對JSON進(jìn)行過濾、遍歷或者結(jié)構(gòu)轉(zhuǎn)換等操作。
項(xiàng)目主頁位于：https://stedolan.github.io/jq/。
你也可以在線體驗(yàn)：https://jqplay.org/。
官方文檔參考：https://stedolan.github.io/jq/manual/#Basicfilters。
下面來讓我們快速入門一下吧！
基礎(chǔ)
$ jq -h
jq - commandline JSON processor [version 1.6]
Usage: jq [options] <jq filter> [file...]
jq [options] --args <jq filter> [strings...]
jq [options] --jsonargs <jq filter> [JSON_TEXTS...]
常見的用法是jq [options] <jq filter> [file...]，例如
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.foo'
{
"bar": {
"baz": 123
}
}
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq -c '.foo.bar'
{"baz":123}其中-c 為options，'.foo' 即為filter，兩者都會在下文介紹
參數(shù)[options]
?? -r output raw strings, not JSON texts
字符串默認(rèn)帶引號，使用-r可以移除字符串的引號
$ echo '{"foo": "bar"}' | jq '.foo'
"bar"
$ echo '{"foo": "bar"}' | jq -r '.foo'
bar?? -c compact instead of pretty-printed output
jq默認(rèn)輸出格式化之后的json，如果希望能在一行輸出使用 -c
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.foo | .bar'
{
"baz": 123
}
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq -c '.foo | .bar'
{"baz":123}過濾器<jq filter>
?? . 輸出原始的 JSON 數(shù)據(jù)
因?yàn)閖q默認(rèn)是格式化的，所以這個(gè)filter可以當(dāng)作格式化
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.'
{
"foo": {
"bar": {
"baz": 123
}
}
}鏈接符
先看下連接符，具體filter的含義下面會介紹。兩個(gè)連接符都是用來組合不同filter來完成特定功能的
?? , 使用多個(gè) filter
需要注意的是使用,每一個(gè)filter產(chǎn)生的輸出都是一行
$ echo '{"user":"stedolan", "projects": ["jq", "wikiflow"]}' | jq '.user, .projects[]'
"stedolan"
"jq"
"wikiflow"?? | 管道
jq '.a.b.c' 、 jq '.a | .b | .c' jq '.a' | jq '.b' | jq '.c'是一樣的
如果第一個(gè)filter產(chǎn)生多個(gè)結(jié)果，那么下一個(gè)filter會對每一個(gè)結(jié)果都執(zhí)行。因此.[] | .foo 取出數(shù)組中的每一個(gè)"foo"
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name'
"JSON"
"XML"對象操作
?? .foo, .foo.bar 獲取對象key的值
'.foo'代表獲取foo這個(gè)key
'.foo.bar' 代表獲取foo對象中的bar，它和上文介紹的 .foo|.bar相同
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.foo'
{
"bar": {
"baz": 123
}
}
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.foo.bar'
{
"baz": 123
}?? 如果對象的key包含特殊字符或者以數(shù)字開頭，使用'.foo'會報(bào)錯(cuò)。此時(shí)需要使用雙引號包裹: ."foo$"、."1foo"
$ echo '{ "1foo": { "bar": { "baz": 123 } } }' | jq '.1foo'
jq: error: syntax error, unexpected IDENT, expecting $end (Unix shell quoting issues?) at <top-level>, line 1:
.1foo
jq: 1 compile error
$ echo '{ "1foo": { "bar": { "baz": 123 } } }' | jq '."1foo"'
{
"bar": {
"baz": 123
}
}??當(dāng)取值不是對象時(shí)jq默認(rèn)會報(bào)錯(cuò)，如果想忽略報(bào)錯(cuò)可以使用 .foo?
$ echo '[1,2,3]' | jq '.foo'
jq: error (at <stdin>:1): Cannot index array with string "foo"
$ echo '[1,2,3]' | jq '.foo?'
數(shù)組操作
?? .[2] 數(shù)組索引
數(shù)組索引也是從0開始，同時(shí)支持負(fù)數(shù)
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[0]'
{
"name": "JSON",
"good": true
}
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[-2]'
{
"name": "JSON",
"good": true
}?? .[10:15] 數(shù)組切片
.[10:15] 包含從從0開始10（含）到15（不含）號元素，如果沒有值則默認(rèn)到頭/尾
$ echo '["a","b","c","d","e"]' | jq '.[1:3]'
[
"b",
"c"
]
$ echo '["a","b","c","d","e"]' | jq '.[1:]'
[
"b",
"c",
"d",
"e"
]
數(shù)組/對象
?? .[] 遍歷
對于數(shù)組來說，會返回?cái)?shù)組中的所有元素
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[]'
{
"name": "JSON",
"good": true
}
{
"name": "XML",
"good": false
}對于對象來說，會返回對象中的所有值
$ echo '{"a":1,"b":[1,2]}' | jq '.[]'
1
[
1,
2
]結(jié)合上文提到管道，可以取出數(shù)組中的每一個(gè)field
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name'
"JSON"
"XML"與shell結(jié)合的常見操作
?? 同時(shí)將json中的多個(gè)值賦值到多個(gè)變量
首先利用, 來同時(shí)解析多個(gè)json字段
其次用echo把多行輸出轉(zhuǎn)換成單行輸出
最后利用read讀取到多個(gè)變量里
$ read json xml <<< $(echo $(echo '{"foo":"JSON","bar":"XML"}' | jq -c '.foo, .bar')) && \
echo "json:$json,xml:$xml"
json:"JSON",xml:"XML"?? 把多個(gè)json字段輸出到一行
上面使用echo是一種方式，還有一種更通用，尤其是處理數(shù)組時(shí)更方便的方式
利用@tsv處理，注意輸入需要是數(shù)組
# 不加處理
$ echo '[{"name":"JSON","good":true},{"name":"XML","good":false}]' | jq -r '.[] | .name, .good'
JSON
true
XML
false
# 利用@tsv處理，注意輸入需要是數(shù)組
$ echo '[{"name":"JSON","good":true},{"name":"XML","good":false}]' | jq -r '.[] | [.name, .good] | @tsv'
JSON true
XML false
# 還可以輸出csv格式的
$ echo '[{"name":"JSON","good":true},{"name":"XML","good":false}]' | jq -r '.[] | [.name, .good] | @csv'
"JSON",true
"XML",false
?? 遍歷數(shù)組
對數(shù)組中的每一個(gè)元素進(jìn)行處理
$ echo '["a","b","c","d","e f"]' | jq -c '.[]' | while read i; do echo "val=${i}"; done
val="a"
val="b"
val="c"
val="d"
val="e f"總結(jié)
以上主要介紹了用jq提取json字段的基礎(chǔ)用法，jq還有函數(shù)，操作符等非常高階的用法。后面有機(jī)會再介紹
