jq命令对JSON进行过滤遍历结构转换等操作实例
作者:凉凉的知识库
引言
jq
是一个灵活的轻量级命令行JSON处理器,你可以使用jq
命令对JSON进行过滤、遍历或者结构转换等操作
项目主页位于:
https://stedolan.github.io/jq/
你也可以在线体验:
官方文档参考:
https://stedolan.github.io/jq/manual/#Basicfilters
下面来让我们快速入门一下吧
基础
$ 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
,两者都会在下文介绍
参数[options]
🌲 -r output raw strings, not JSON texts
字符串默认带引号,使用-r
可以移除字符串的引号
$ echo '{"foo": "bar"}' | jq '.foo' "bar" $ echo '{"foo": "bar"}' | jq -r '.foo' bar
🌲 -c compact instead of pretty-printed output
jq默认输出格式化之后的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 数据
因为jq默认是格式化的,所以这个filter
可以当作格式化
$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.' { "foo": { "bar": { "baz": 123 } } }
链接符
先看下连接符,具体filter的含义下面会介绍。两个连接符都是用来组合不同filter来完成特定功能的
🌲 , 使用多个 filter
需要注意的是使用,
每一个filter产生的输出都是一行
$ 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'
是一样的
如果第一个filter产生多个结果,那么下一个filter会对每一个结果都执行。因此.[] | .foo
取出数组中的每一个"foo"
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name' "JSON" "XML"
对象操作
🌲 .foo, .foo.bar 获取对象key的值
'.foo'
代表获取foo
这个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包含特殊字符或者以数字开头,使用'.foo'
会报错。此时需要使用双引号包裹: ."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 } }
❗️当取值不是对象时jq默认会报错,如果想忽略报错可以使用 .foo?
$ echo '[1,2,3]' | jq '.foo' jq: error (at <stdin>:1): Cannot index array with string "foo" $ echo '[1,2,3]' | jq '.foo?'
数组操作
🌲 .[2] 数组索引
数组索引也是从0开始,同时支持负数
$ 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] 数组切片
.[10:15]
包含从从0开始10(含)到15(不含)号元素,如果没有值则默认到头/尾
$ echo '["a","b","c","d","e"]' | jq '.[1:3]' [ "b", "c" ] $ echo '["a","b","c","d","e"]' | jq '.[1:]' [ "b", "c", "d", "e" ]
数组/对象
🌲 .[] 遍历
对于数组来说,会返回数组中的所有元素
$ 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 ]
结合上文提到管道,可以取出数组中的每一个field
$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name' "JSON" "XML"
与shell结合的常见操作
🌲 同时将json中的多个值赋值到多个变量
首先利用,
来同时解析多个json字段
其次用echo
把多行输出转换成单行输出
最后利用read
读取到多个变量里
$ read json xml <<< $(echo $(echo '{"foo":"JSON","bar":"XML"}' | jq -c '.foo, .bar')) && \ echo "json:$json,xml:$xml" json:"JSON",xml:"XML"
🌲 把多个json字段输出到一行
上面使用echo是一种方式,还有一种更通用,尤其是处理数组时更方便的方式
利用@tsv
处理,注意输入需要是数组
# 不加处理 $ echo '[{"name":"JSON","good":true},{"name":"XML","good":false}]' | jq -r '.[] | .name, .good' JSON true XML false # 利用@tsv处理,注意输入需要是数组 $ 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
🌲 遍历数组
对数组中的每一个元素进行处理
$ 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"
总结
以上主要介绍了用jq
提取jso
,更多关于jq命令操作JSON的资料请关注脚本之家其它相关文章!