json-query-tool — JSON 查询工具
痛点
- jq 语法复杂，学习成本高
- 只想快速提取 JSON 中的某个字段，却要写一长串表达式
- 需要在 shell 脚本中处理 JSON，但不想引入额外依赖
- 不同格式输出（表格、纯文本）要手动转换
场景
- 从 API 响应 JSON 中提取指定字段
- 查询 JSON 配置文件中的某个值
- 日志文件是 JSON Lines 格式，批量提取字段
- 将 JSON 数据导出为易读的表格形式
定价
- 免费：基础路径查询 + JSON/纯文本输出
- Pro 19元：表格输出 + 类型过滤 + 通配符支持
- Team 49元：批量文件处理 + 管道集成 + 自定义格式
指令格式
基本用法
jsonq <文件> <路径表达式>
输出格式
jsonq <文件> <路径> --format raw|json|table
查询语法
| 模式 | 说明 | 示例 |
|---|
key | 对象属性访问 | users.name |
parent.child | 嵌套访问 | user.profile.email |
[n] | 数组索引 | users[0] |
[*] | 全部数组元素 | users[*] |
* | 通配符键名 | users.*.name |
:type | 类型过滤 | age:number |
示例
示例 JSON
{
"users": [
{"name": "Alice", "age": 30, "email": "alice@example.com"},
{"name": "Bob", "age": 25, "email": "bob@example.com"}
],
"company": {
"name": "TechCorp",
"departments": [
{"name": "Engineering", "head": "Carol"},
{"name": "Sales", "head": "Dave"}
]
}
}
查询示例
# 获取所有用户名
jsonq data.json "users[*].name"
["Alice", "Bob"]
# 获取第一个用户的邮箱
jsonq data.json "users[0].email"
alice@example.com
# 获取部门名称列表
jsonq data.json "company.departments[*].name"
["Engineering", "Sales"]
# 表格形式输出
jsonq data.json "users[*]" --format table
name age email
Alice 30 alice@example.com
Bob 25 bob@example.com
# 类型过滤：只取数字字段
jsonq data.json "users[0]" --format json
{"name": "Alice", "age": 30, "email": "alice@example.com"}
安装
# 本地安装
pip install -e .
# 或直接使用
chmod +x jsonq
./jsonq data.json "field"
