-
-
Notifications
You must be signed in to change notification settings - Fork 1.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
0bfe15e
commit f28c93b
Showing
2 changed files
with
243 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,236 @@ | ||
| jq 备忘清单 | ||
| === | ||
|
|
||
| 这个快速参考备忘单提供了使用 [jq](https://stedolan.github.io/jq/) 命令的各种方法。 | ||
|
|
||
| 入门 | ||
| ---- | ||
|
|
||
| ### 介绍 | ||
|
|
||
| jq 就像用于 JSON 数据的 [sed](./sed.md) - 您可以使用它来切片、过滤、映射和转换结构化数据 | ||
|
|
||
| - [jq 官网](https://stedolan.github.io/jq/) _(stedolan.github.io)_ | ||
| - [jq 命令使用](https://jaywcjlove.github.io/linux-command/c/jq.html) _(jaywcjlove.github.io)_ | ||
|
|
||
| 安装 | ||
|
|
||
| ```bash | ||
| $ sudo apt-get install jq # Debian& Ubuntu | ||
| $ sudo dnf install jq # Fedora | ||
| $ sudo zypper install jq # openSUSE | ||
| $ sudo pacman -S jq # Arch | ||
| $ brew install jq # macOS & Homebrew | ||
| $ port install jq # macOS & MacPorts | ||
| ``` | ||
|
|
||
| 语法 | ||
|
|
||
| ```bash | ||
| $ jq [options] <jq filter> [file...] | ||
| $ jq [options] --args <jq filter> [strings...] | ||
| $ jq [options] --jsonargs <jq filter> [JSON_TEXTS...] | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| ### 选项 | ||
| <!--rehype:wrap-class=col-span-2--> | ||
|
|
||
| :- | - | ||
| :- | - | ||
| `-c` | 紧凑而不是漂亮的输出 | ||
| `-n` | 使用`null`作为单个输入值 | ||
| `-e` | 根据输出设置退出状态代码 | ||
| `-s` | 将所有输入读取（吸取）到数组中；应用过滤器 | ||
| `-r` | 输出原始字符串，而不是JSON文本 | ||
| `-R` | 读取原始字符串，而不是JSON文本 | ||
| `-C` | 为 JSON 着色 | ||
| `-M` | 单色（不要为JSON着色） | ||
| `-S` | 在输出上排序对象的键 | ||
| `--tab` | 使用制表符进行缩进 | ||
| `--arg a v` | 将变量 `$a` 设置为 value `<v>` | ||
| `--argjson a v` | 将变量 `$a` 设置为 JSON value `<v>` | ||
| `--slurpfile a f` | 将变量 `$a` 设置为从`<f>`读取的JSON文本数组 | ||
| `--rawfile a f` | 将变量 `$a` 设置为包含`<f>`内容的字符串 | ||
| `--args` | 其余参数是字符串参数，而不是文件 | ||
| `--jsonargs` | 其余的参数是JSON参数，而不是文件 | ||
| `--` | 终止参数处理 | ||
|
|
||
| 学习示例 | ||
| --- | ||
|
|
||
| ### 获取一个键的值 | ||
|
|
||
| ```bash | ||
| $ echo '{"foo": 42, "bar": "less interesting data"}' | jq '.foo' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| 42 | ||
| ``` | ||
|
|
||
| ### 数组运算 | ||
|
|
||
| ```bash | ||
| $ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[1]' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| { | ||
| "name": "XML", | ||
| "good": false | ||
| } | ||
| ``` | ||
|
|
||
| ### 构造一个数组/对象 | ||
|
|
||
| ```bash | ||
| $ echo '{"user":"stedolan","titles":["JQ Primer", "More JQ"]}' | jq '{user, title: .titles[]}' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| { | ||
| "user": "stedolan", | ||
| "title": "JQ Primer" | ||
| } | ||
| { | ||
| "user": "stedolan", | ||
| "title": "More JQ" | ||
| } | ||
| ``` | ||
|
|
||
| ### 计算一个值的长度 | ||
|
|
||
| ```bash | ||
| $ echo '[[1,2], "string", {"a":2}, null]' | jq '.[] | length' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| 2 | ||
| 6 | ||
| 1 | ||
| 0 | ||
| ``` | ||
|
|
||
| ### 取出数组中的键 | ||
|
|
||
| ```bash | ||
| $ echo '{"abc": 1, "abcd": 2, "Foo": 3}' | jq 'keys' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| [ | ||
| "Foo", | ||
| "abc", | ||
| "abcd" | ||
| ] | ||
| ``` | ||
|
|
||
| ### 使用多个过滤器 | ||
|
|
||
| ```bash | ||
| $ echo '{ "foo": 42, "bar": "something else", "baz": true}' | jq '.foo, .bar' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| 42 | ||
| "something else" | ||
| ``` | ||
|
|
||
| ### 管道传递给下一个过滤器 | ||
|
|
||
| ```bash | ||
| $ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| "JSON" | ||
| "XML" | ||
| ``` | ||
|
|
||
| ### 条件语句判断 | ||
|
|
||
| ```bash | ||
| $ echo '[1,5,3,0,7]' | jq 'map(select(. >= 2))' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| [ | ||
| 5, | ||
| 3, | ||
| 7 | ||
| ] | ||
| ``` | ||
|
|
||
| ### 每个输入调用过滤器 | ||
|
|
||
| ```bash | ||
| $ echo '[1,2,3]' | jq 'map(.+1)' | ||
| ``` | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| [ | ||
| 2, | ||
| 3, | ||
| 4 | ||
| ] | ||
| ``` | ||
|
|
||
| ### 条件判断 | ||
|
|
||
| ```bash | ||
| $ echo '2' | jq 'if . == 0 then "zero" elif . == 1 then "one" else "many" end' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| "many" | ||
| ``` | ||
|
|
||
| ### 字符串插入值并进行运算 | ||
|
|
||
| ```bash | ||
| $ echo '42' | jq '"The input was \(.), which is one less than \(.+1)"' | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 输出结果 | ||
|
|
||
| ```bash | ||
| "The input was 42, which is one less than 43" | ||
| ``` | ||
| <!--rehype:className=wrap-text --> | ||
|
|
||
| 另见 | ||
| ---- | ||
|
|
||
| - [jq 官网](https://stedolan.github.io/jq/) _(stedolan.github.io)_ | ||
| - [jq 命令使用](https://jaywcjlove.github.io/linux-command/c/jq.html) _(jaywcjlove.github.io)_ |