介绍
# jq JSON Processor
使用 jq 处理、过滤和转换 JSON 数据。
## 快速示例
### 基本过滤 ```bash # Extract a field echo '{"name":"Alice","age":30}' | jq '.name' # Output: "Alice"
# Multiple fields echo '{"name":"Alice","age":30}' | jq '{name: .name, age: .age}'
# Array indexing echo '[1,2,3,4,5]' | jq '.[2]' # Output: 3 ```
### 处理数组 ```bash # Map over array echo '[{"name":"Alice"},{"name":"Bob"}]' | jq '.[].name' # Output: "Alice" "Bob"
# Filter array echo '[1,2,3,4,5]' | jq 'map(select(. > 2))' # Output: [3,4,5]
# Length echo '[1,2,3]' | jq 'length' # Output: 3 ```
### 常用操作 ```bash # Pretty print JSON cat file.json | jq '.'
# Compact output cat file.json | jq -c '.'
# Raw output (no quotes) echo '{"name":"Alice"}' | jq -r '.name' # Output: Alice
# Sort keys echo '{"z":1,"a":2}' | jq -S '.' ```
### 高级过滤 ```bash # Select with conditions jq '[.[] | select(.age > 25)]' people.json
# Group by jq 'group_by(.category)' items.json
# Reduce echo '[1,2,3,4,5]' | jq 'reduce .[] as $item (0; . + $item)' # Output: 15 ```
### 处理文件 ```bash # Read from file jq '.users[0].name' users.json
# Multiple files jq -s '.[0] * .[1]' file1.json file2.json
# Modify and save jq '.version = "2.0"' package.json > package.json.tmp && mv package.json.tmp package.json ```
## 常见用例
**从 API 响应中提取特定字段：** ```bash curl -s https://api.github.com/users/octocat | jq '{name: .name, repos: .public_repos, followers: .followers}' ```
**转换类 CSV 数据：** ```bash jq -r '.[] | [.name, .email, .age] | @csv' users.json ```
**调试 API 响应：** ```bash curl -s https://api.example.com/data | jq '.' ```
## 提示
- 使用 `-r` 获取原始字符串输出（移除引号） - 使用 `-c` 获取紧凑输出（单行） - 使用 `-S` 对对象键进行排序 - 使用 `--arg name value` 传递变量 - 管道连接多个 jq 操作：`jq '.a' | jq '.b'`
## 文档
完整手册：https://jqlang.github.io/jq/manual/ 交互式教程：https://jqplay.org/