macos jq 命令详解 AG chatgpt 有大用 有大大用 有大大大用

macos jq 命令详解 

jq (json query)是一个强大的命令行 JSON 处理器，在 macOS（或任何 Unix 系统）中用于解析、过滤、转换和操作 JSON 数据。以下是 jq 的详细用法说明：

1. 基本安装

macOS 通常未预装 jq，可通过以下命令安装：

bash
    
brew install jq  # 使用 Homebrew
    

2. 基础语法

bash
    
jq [options] <filter> [file.json]
    

• 若未指定 file.json，则从标准输入（stdin）读取数据。

3. 常用选项

4. 核心功能与示例

4.1 读取 JSON 文件

bash
    
jq '.' data.json      # 格式化输出整个文件
cat data.json | jq    # 通过管道输入
    

4.2 提取字段

bash
    
jq '.key' data.json               # 提取顶级键
jq '.parent.child' data.json      # 嵌套提取
jq '.array[0]' data.json          # 数组索引
jq '.object[]' data.json         # 遍历对象值
    

4.3 条件过滤

bash
    
jq 'select(.age > 30)' data.json       # 筛选 age > 30
jq 'map(select(.enabled))' data.json   # 过滤数组元素
    

4.4 数学运算

bash
    
jq '.numbers | length' data.json       # 计算数组长度
jq '.prices | add' data.json           # 求和
jq '. | max' data.json                 # 最大值
    

4.5 修改与构造 JSON

bash
    
jq '.name = "New Name"' data.json     # 修改字段
jq '. + { "newKey": "value" }' data.json  # 添加字段
jq '[.users[] | {name}]' data.json    # 构造新数组
    

4.6 管道操作

bash
    
jq '.users[] | .name' data.json      # 提取所有用户名
jq '.data | keys' data.json          # 获取所有键名
    

4.7 变量传递

bash
    
jq --arg user "Alice" '.name = $user' data.json
    

5. 高级用法

• 正则匹配：jq 'match("pattern")'

• 自定义函数：jq 'def add(x,y): x+y; add(1,2)'

• 错误处理：jq 'try .key catch "default"'

6. 实用示例

6.1 提取嵌套数据

bash
    
jq '.users[].address.city' data.json
    

6.2 重命名字段

bash
    
jq '. | {newName: .oldName}' data.json
    

6.3 合并多个 JSON

bash
    
jq -s '.[0] * .[1]' file1.json file2.json
    

6.4 提取 API 响应

bash
    
curl -s https://api.example.com/data | jq '.results[] | {id, name}'
    

7. 输出控制

bash
    
jq -r '.name' data.json        # 直接输出字符串（无引号）
jq -c '.' data.json            # 单行紧凑 JSON
    

8. 调试技巧

• 使用 debug 函数：jq 'debug | .key' data.json

• 逐步调试：分步执行管道操作。

掌握 jq 可以高效处理 JSON 数据，尤其在脚本和 API 交互中非常实用。更多功能参考官方手册：
👉 jq Manual

echo '{"name": "John"}' | jq -r '.name' 详解

让我们逐步解析这个命令的执行过程和原理：

bash
echo '{"name": "John"}' | jq -r '.name'

1. 命令分解

2. 执行步骤详解

1. echo 输出 JSON

   bash
   echo '{"name": "John"}'

• 输出字符串：{"name": "John"}（注意：此时只是一个字符串，还不是 JSON 对象）

• 上一步的字符串通过管道 (|) 传递给 jq

• jq 会自动将输入字符串解析为 JSON 对象：

  json
  {
    "name": "John"
  }

• 过滤器 .name 表示提取 JSON 中的 name 字段

• 处理结果：JSON 字符串 "John"
  （注意：这是合法的 JSON 字符串，包含双引号）

• -r (raw-output) 会去掉结果中的 JSON 引号，输出纯文本

• 最终输出：John（没有引号）

3. 对比有无 -r 的输出

4. 典型应用场景

1. 赋值给 Shell 变量

   bash
   name=$(echo '{"name": "John"}' | jq -r '.name')
   echo "Hello, $name!"  # 输出：Hello, John!

2. 直接处理非 JSON 系统

   bash
   # 将结果传递给需要纯文本的命令
   echo '{"name": "John"}' | jq -r '.name' | grep "John"

3. 生成配置文件

   bash
   echo '{"port": 8080}' | jq -r '.port' > config.port

5. 常见错误处理

1. 字段不存在时

   bash
   echo '{"age": 30}' | jq -r '.name'

• 输出：null（不会报错）

• 解决方法：用 // 设置默认值

  bash
  echo '{"age": 30}' | jq -r '.name // "unknown"'

bash
echo "Not JSON" | jq '.name'

• 会报错：parse error: Invalid numeric literal

• 解决方法：先验证输入

  bash
  echo $data | jq -e '. 2>/dev/null || echo "Invalid JSON"

6. 进阶用法

1. 嵌套对象提取

   bash
   echo '{"user": {"name": "John"}}' | jq -r '.user.name'

2. 数组处理

   bash
   echo '{"names": ["John", "Alice"]}' | jq -r '.names[]'

这个简单的 jq 命令组合是处理 JSON 的基础操作，理解了它就能举一反三处理更复杂的场景。