简介

gron 是一个独特的命令行工具，用于将 JSON 数据转换为离散的、易于 grep 处理的赋值语句格式。它的名字来源于 "grepable on" 或 "grepable JSON"，主要解决在命令行中处理复杂 JSON 数据的难题。

核心价值

gron 的核心是将 JSON 数据展平为类似 json.path.to.key = value; 的格式

• 简化 JSON 处理：将嵌套的 JSON 结构扁平化为易于搜索的格式
• 增强 grep 能力：使标准文本工具能高效处理 JSON 数据
• 可逆转换：可将处理后的数据还原为原始 JSON

安装

• Ubuntu/Debian

sudo apt install gron

• CentOS/RHEL

sudo yum install epel-release
sudo yum install gron

• macOS

brew install gron

• 从源码安装 (Go)

go install github.com/tomnomnom/gron@latest

常用选项

• -c, --color：强制彩色输出（即使非终端环境）。
• -i, --indent：指定缩进空格数（默认 2）。
• -n, --no-sort：不排序输出结果。
• -u, --ungron：将 gron 格式转回 JSON。
• --json：等同于 --ungron，但更符合语义。
• -v, --values: 仅输出值的部分（不包括路径）
• -s, --stream: 将每行输入视为单独的 JSON 对象处理

示例用法

data.json 文件示例：

{
  "name": "Alice",
  "age": 30,
  "pets": [
    {"name": "Rex", "type": "dog"},
    {"name": "Whiskers", "type": "cat"}
  ],
  "address": {
    "city": "New York",
    "zip": "10001"
  }
}

转换 JSON 为 gron 格式

gron data.json

输出：

json = {};
json.name = "Alice";
json.age = 30;
json.pets = [];
json.pets[0] = {};
json.pets[0].name = "Rex";
json.pets[0].type = "dog";
json.pets[1] = {};
json.pets[1].name = "Whiskers";
json.pets[1].type = "cat";
json.address = {};
json.address.city = "New York";
json.address.zip = "10001";

搜索特定值

gron data.json | grep "zip"

输出：

json.address.zip = "10001";

恢复为 JSON 格式 (--ungron)

gron data.json | grep "pets" | gron --ungron

输出：

{
  "pets": [
    {
      "name": "Rex",
      "type": "dog"
    },
    {
      "name": "Whiskers",
      "type": "cat"
    }
  ]
}

使用自定义变量名 (-s)

gron -s data data.json

输出：

data = {};
data.name = "Alice";

流式处理大型文件 (--stream)

curl -s https://api.example.com/large-data | gron --stream

指定输出格式 (-j, --json)

gron data.json -j | grep "name"

输出：

$.name = "Alice";
$.pets[0].name = "Rex";
$.pets[1].name = "Whiskers";

组合 awk 处理数据

gron data.json | awk '/pets/ && /type/ {print $3}'

输出：

"dog"
"cat"

修改并恢复数据

gron data.json | sed 's/"New York"/"Boston"/' | gron --ungron

处理多个文件

gron file1.json file2.json | grep "error"

使用 jq 风格路径

gron -j data.json | grep 'pets.*name'

输出：

$.pets[0].name = "Rex";
$.pets[1].name = "Whiskers";

调试 API 响应

curl -s https://api.github.com/users/octocat | gron | grep "company"

处理复杂配置文件

gron config.json | grep "database.password"

搜索嵌套值

gron data.json | grep "pets.*cat"

提取所有键名

gron data.json | awk -F '.' '{print $2}' | sort | uniq

处理压缩数据

zcat large.json.gz | gron --stream | grep "error"

颜色高亮输出

gron data.json | grep --color=auto "name"