|
@@ -1,262 +0,0 @@
|
|
|
-### 导读
|
|
|
-
|
|
|
-JSON 是一种常见的数据格式,但 zsh 并没有原生的方法处理 JSON 数据,好在有一个功能强大易用的 [jq](https://stedolan.github.io/jq/) 命令行工具。本文主要讲 jq 命令的方法,虽然网上有很多相关资料,但比较零散不成系统,用于学习尚可,但作为手册查询的话并不方便。本文会将所有相关资料组织起来,便于学习和查询。本文使用的 jq 版本为 1.5。
|
|
|
-
|
|
|
-需要注意的是如果要频繁处理 JSON 数据,用 zsh 并不合适,因为频繁调用 jq 命令会带来巨大的进程启动开销,而且 zsh 和 jq 之间的衔接也不是很自然,总体上并不如 Python 等语言好用。
|
|
|
-
|
|
|
-### 读取字段
|
|
|
-
|
|
|
-示例文件 test.json:
|
|
|
-
|
|
|
-```
|
|
|
-{
|
|
|
- "int": 100,
|
|
|
- "str": "hello",
|
|
|
- "array": [
|
|
|
- "array_element1",
|
|
|
- "array_element2",
|
|
|
- "array_element3"
|
|
|
- ],
|
|
|
- "hashtable": {
|
|
|
- "k1": "v1",
|
|
|
- "k2": "v2",
|
|
|
- "k3": "v3",
|
|
|
- "k4": [
|
|
|
- "aaa",
|
|
|
- "bbb",
|
|
|
- "ccc"
|
|
|
- ]
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-用法示例:
|
|
|
-
|
|
|
-```
|
|
|
-# 读取一个整数
|
|
|
-% cat test.json | jq .int
|
|
|
-100
|
|
|
-
|
|
|
-# 或者直接加文件名
|
|
|
-# 我为了方便修改统一使用 cat,实际使用时建议加文件名,可以少启动一个进程
|
|
|
-% jq .int test.json
|
|
|
-100
|
|
|
-
|
|
|
-# 读取一个字符串,输出带引号
|
|
|
-% cat test.json | jq .str
|
|
|
-"hello"
|
|
|
-
|
|
|
-# 读取一个字符串,输出不带引号,但注意字段不存在的情况
|
|
|
-% cat test.json | jq -r .str
|
|
|
-hello
|
|
|
-
|
|
|
-# 读取不存在的字段
|
|
|
-% cat test.json | jq .strr
|
|
|
-null
|
|
|
-
|
|
|
-# 读取一个数组
|
|
|
-% cat test.json | jq .array
|
|
|
-[
|
|
|
- "array_element1",
|
|
|
- "array_element2",
|
|
|
- "array_element3"
|
|
|
-]
|
|
|
-
|
|
|
-# 读取数组第一个元素,也可以加 -r 去掉引号,不赘述
|
|
|
-% cat test.json | jq '.array[0]'
|
|
|
-"array_element1"
|
|
|
-
|
|
|
-# 可以用 noglob 去掉 .array[0] 两边的引号,alias 下可以方便很多
|
|
|
-% cat test.json | noglob jq .array[0]
|
|
|
-"array_element1"
|
|
|
-
|
|
|
-# 读取一个哈希表
|
|
|
-% cat test.json | jq .hashtable
|
|
|
-{
|
|
|
- "k1": "v1",
|
|
|
- "k2": "v2",
|
|
|
- "k3": "v3",
|
|
|
- "k4": [
|
|
|
- "aaa",
|
|
|
- "bbb",
|
|
|
- "ccc"
|
|
|
- ]
|
|
|
-}
|
|
|
-
|
|
|
-# 读取哈希表中的一个元素
|
|
|
-% cat test.json | jq .hashtable.k2
|
|
|
-"v2"
|
|
|
-
|
|
|
-# 也可以这样,某些复杂场景中分开写比较方便,类似管道
|
|
|
-% cat test.json | jq '.hashtable | .k2'
|
|
|
-"v2"
|
|
|
-
|
|
|
-# 读取哈希表中的数组元素
|
|
|
-% cat test.json | jq '.hashtable.k4[1]'
|
|
|
-"bbb"
|
|
|
-
|
|
|
-# 格式化 JSON 数据
|
|
|
-% cat test.json | jq
|
|
|
-{
|
|
|
- "int": 100,
|
|
|
- "str": "hello",
|
|
|
- "array": [
|
|
|
- "array_element1",
|
|
|
- "array_element2",
|
|
|
- "array_element3"
|
|
|
- ],
|
|
|
- "hashtable": {
|
|
|
- "k1": "v1",
|
|
|
- "k2": "v2",
|
|
|
- "k3": "v3",
|
|
|
- "k4": [
|
|
|
- "aaa",
|
|
|
- "bbb",
|
|
|
- "ccc"
|
|
|
- ]
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-### 数组相关操作
|
|
|
-
|
|
|
-实例文件 array.json:
|
|
|
-
|
|
|
-```
|
|
|
-[
|
|
|
- [
|
|
|
- "aaa",
|
|
|
- "bbb",
|
|
|
- "ccc"
|
|
|
- ],
|
|
|
- [
|
|
|
- "ddd",
|
|
|
- "eee",
|
|
|
- "fff"
|
|
|
- ]
|
|
|
-]
|
|
|
-```
|
|
|
-
|
|
|
-### 数组读取
|
|
|
-
|
|
|
-```
|
|
|
-# 读取数组长度
|
|
|
-% cat array.json | jq length
|
|
|
-2
|
|
|
-
|
|
|
-# 读取第一个元素
|
|
|
-% cat array.json | jq '.[0]'
|
|
|
-[
|
|
|
- "aaa",
|
|
|
- "bbb",
|
|
|
- "ccc"
|
|
|
-]
|
|
|
-
|
|
|
-# 读取第一个元素的数组长度,这里的用法类似管道
|
|
|
-% cat array.json | jq '.[0] | length'
|
|
|
-3
|
|
|
-
|
|
|
-# 嵌套读取数组元素
|
|
|
-% cat array.json | jq '.[1][1]'
|
|
|
-"eee"
|
|
|
-
|
|
|
-# 也可以分开写
|
|
|
-% cat array.json | jq '.[1] | .[1]'
|
|
|
-"eee"
|
|
|
-
|
|
|
-# 数组切片,[m:n] 包含 [m] 不包含 [n]
|
|
|
-% cat array.json | jq '.[1][0:2]'
|
|
|
-[
|
|
|
- "ddd",
|
|
|
- "eee"
|
|
|
-]
|
|
|
-```
|
|
|
-
|
|
|
-#### 数组相关函数
|
|
|
-
|
|
|
-#### 数组写入
|
|
|
-
|
|
|
-### 哈希表相关操作
|
|
|
-
|
|
|
-实例文件 hashtable.json:
|
|
|
-
|
|
|
-```
|
|
|
-{
|
|
|
- "h1": {
|
|
|
- "k1": "v1",
|
|
|
- "k2": "v2",
|
|
|
- "k3": "v3"
|
|
|
- },
|
|
|
- "h2": {
|
|
|
- "k4": "v4",
|
|
|
- "k5": "v5",
|
|
|
- "k6": "v6"
|
|
|
- }
|
|
|
-}
|
|
|
-
|
|
|
-```
|
|
|
-
|
|
|
-#### 哈希表读取
|
|
|
-
|
|
|
-```
|
|
|
-# 读取哈希表长度
|
|
|
-% cat hashtable.json | jq length
|
|
|
-2
|
|
|
-
|
|
|
-% cat hashtable.json | jq '.h1 | length'
|
|
|
-3
|
|
|
-
|
|
|
-# 读取哈希表中所有键,以数组形式返回
|
|
|
-% cat hashtable.json | jq keys
|
|
|
-[
|
|
|
- "h1",
|
|
|
- "h2"
|
|
|
-]
|
|
|
-
|
|
|
-# 判断键是否存在
|
|
|
-% cat hashtable.json | jq 'has("h1")'
|
|
|
-true
|
|
|
-% cat hashtable.json | jq 'has("h3")'
|
|
|
-false
|
|
|
-% cat hashtable.json | jq '.h1 | has("k3")'
|
|
|
-true
|
|
|
-
|
|
|
-# 将值取出来
|
|
|
-% cat hashtable.json | jq '.[]'
|
|
|
-{
|
|
|
- "k1": "v1",
|
|
|
- "k2": "v2",
|
|
|
- "k3": "v3"
|
|
|
-}
|
|
|
-{
|
|
|
- "k4": "v4",
|
|
|
- "k5": "v5",
|
|
|
- "k6": "v6"
|
|
|
-}
|
|
|
-
|
|
|
-# 此处不能用 jq '.h1.[]'
|
|
|
-% cat hashtable.json | jq '.h1 | .[]'
|
|
|
-"v1"
|
|
|
-"v2"
|
|
|
-"v3"
|
|
|
-
|
|
|
-
|
|
|
-```
|
|
|
-
|
|
|
-#### 哈希表相关函数
|
|
|
-
|
|
|
-#### 哈希表写入
|
|
|
-
|
|
|
-### 内置运算
|
|
|
-
|
|
|
-### 变量
|
|
|
-
|
|
|
-### 总结
|
|
|
-
|
|
|
-待完善。
|
|
|
-
|
|
|
-### 参考
|
|
|
-
|
|
|
-https://www.ibm.com/developerworks/cn/linux/1612_chengg_jq/index.html
|
|
|
-
|
|
|
-https://stedolan.github.io/jq/manual/
|