Перейти к основному содержимому
kitlocal.dev

Шпаргалка по jq

Работает локально

На 100% обрабатывается в вашем браузере. Входные и выходные данные никогда не покидают ваше устройство.

Фильтры JSON-процессора jq, конвейеры, конструирование объектов, массивы, select, map, group_by, reduce и флаги CLI, проверенные на jq 1.8.

Принцип работы

Every jq filter transforms an input JSON stream into zero or more output JSON values. Dot (`.`) is the identity filter; pipes (`|`) pass each output of the left filter into the right filter, and `.[]` explodes an array or object into a stream of items so you can filter, map and re-wrap them with `[...]`.

Набор для выживания

Несколько команд, которые стоит выучить в первую очередь.

40 команд

Горячие клавиши/Фокус на поискJKПереместить выборCКопировать выбранноеFДобавить выбранное в закладкиEscОчистить поиск

Inspect & format JSON

Start with `.` to validate and pretty-print JSON, or `-r`/`-c` to adapt formatting for downstream tools.

Официальная документация: Invoking jq
  • Базовый

    Validate and pretty-print JSON with syntax highlighting.

    jq . <file.json>

    Когда использовать

    Quickly format minified API responses or confirm JSON syntax from the terminal.

    Разбор

    .
    identity filter: passes the whole JSON value unchanged

    Пример

    echo '{"b":2,"a":1}' | jq -c .

    Результат

    {"b":2,"a":1}

    Другие варианты

    • jq -S . <file.json> (sort object keys alphabetically)

    См. также

Access fields & arrays

Chain property names with `.a.b`, index arrays with `.[0]`, and append `?` to skip missing/null errors.

Официальная документация: Basic filters

Filter & transform

Combine `select(cond)` to drop items and `map(...)` or `[...]` to transform the remaining ones.

Официальная документация: Builtin operators & functions

Sort, group & aggregate

Group records by a key, deduplicate, compute totals, or flatten nested arrays.

Официальная документация: Sorting and grouping

CLI variables, CSV & shell interop

Pass shell parameters safely with `--arg` / `--argjson` and export tables directly with `@csv` or `@tsv`.

Официальная документация: Format strings and escaping

Попробуйте в инструменте KitLocal

Глоссарий
Filter
An expression in jq that takes a JSON value and outputs zero or more values.
Stream
Multiple values produced by `.[]` or `,` before wrapping back into an array with `[...]`.
Raw output (-r)
Outputs strings without JSON surrounding quotes — essential when feeding bash or grep.
Compact (-c)
Prints each JSON object on a single line (NDJSON / JSON Lines).

Проверено: 15 нояб. 2026 г. · Проверено на версии jq 1.8

Источники: jq Manual (jqlang.org)

Замените любые значения в угловых скобках на свои. Команды взяты из официальной документации, а примеры проверены на указанной версии.