Bash JSON Viewer — jless & JQ_COLORS

Коли потрібен переглядач JSON у bash для інтерактивного дослідження, а не для скриптингу, стандартний jq . не справляється — вивід прокручується повз верхню частину терміналу, і немає можливості повернутися до 300-рядкової відповіді API. Цей посібник охоплює інструменти, створені спеціально для інтерактивного перегляду JSON у терміналі: jless (дерево що згортається з vim-навігацією), JQ_COLORS для налаштування колірних тем, jq -C | less -R для кольорового гортання, псевдоніми оболонки для щоденного використання та fx як альтернатива на Node.js. Для скриптингу, CI/CD та робочих процесів валідації дивіться супутній посібник із форматування JSON у Bash. Для браузерного перегляду без встановлення інструмент JSON Pretty Print працює миттєво. Приклади протестовано на Bash 5.x (macOS через Homebrew, Ubuntu 22.04+) та сумісні з Bash 3.2+ (системна оболонка macOS).

Інтерактивний vs. Скриптовий перегляд JSON

Передача JSON у jq . — правильний вибір для форматованого виводу невеликих даних або коли результат подається в іншу команду. Це неправильний вибір, коли потрібно досліджувати відповідь API з 200 полями — вивід промайне у вікні терміналу і не дасть жодної можливості навігувати, згортати розділи або шукати конкретне поле без повторного запуску команди з фільтром. Інтерактивні JSON-переглядачі відображають той самий форматований та кольоровий вивід всередині постійного пейджера з керованою навігацією. Дані ідентичні; різниця — в інтерфейсі.

# jq . — вивід прокручується за екран для великих відповідей
curl -s https://api.github.com/users/torvalds | jq .
# 300+ рядків прокручуються — контекст втрачається миттєво

# jless — відкриває інтерактивний пейджер, нічого не прокручується
curl -s https://api.github.com/users/torvalds | jless
# Повний документ видимий, згортається, шукається за допомогою j/k/h/l

jless — Інтерактивний JSON-переглядач

jless — спеціалізований термінальний JSON-переглядач. На відміну від простого пайпу через jq, він відображає документ як постійне дерево що згортається: кожен об'єкт і масив можна незалежно розгортати та згортати за допомогою l та h, навігація використовує vim-клавіші, а інкрементальний пошук миттєво знаходить будь-який ключ або значення. Він читає ввід потоково, тому відкриває великі файли та відповіді API менш ніж за секунду незалежно від розміру — де jq буферизує весь документ перед відображенням. Я першим ділом тягнуся до jless, коли відповідь API занадто велика для побіжного перегляду.

Встановлення

# macOS
brew install jless

# Linux — готовий бінарник із GitHub Releases
curl -sL https://github.com/PaulJuliusMartinez/jless/releases/latest/download/jless-x86_64-unknown-linux-gnu.tar.gz \
  | tar xz
sudo mv jless /usr/local/bin/

# Перевірка
jless --version

Базове використання

# Відкрити локальний файл — інтерактивний переглядач запускається негайно
jless api-response.json

# Передати будь-який JSON-потік безпосередньо в jless
curl -s https://api.github.com/users/torvalds | jless

# Відкрити з усіма вузлами, згорнутими до верхнього рівня (зручна відправна точка для великих документів)
jless --mode line api-response.json

# Завантажити конкретний елемент масиву і переглянути окремо
jq '.[0]' deployments.json | jless

Навігація та пошук на практиці

# Всередині jless:
#
#   j / ↓        вниз
#   k / ↑        вгору
#   l / →        розгорнути вузол (або Enter)
#   h / ←        згорнути вузол
#   H            згорнути поточний + усіх сусідів → огляд верхнього рівня
#   L            розгорнути все рекурсивно
#
#   /            почати пошук уперед — введіть ім'я ключа та натисніть Enter
#   n / N        наступний / попередній збіг
#
#   g / gg       перейти до початку
#   G            перейти до кінця
#   q            вийти

Довідник клавіш jless

Усі клавіші доступні відразу після відкриття jless — жодного налаштування не потрібно. Модель навігації навмисно ідентична vim, щоб існуюча м'язова пам'ять переносилася.

jq -C | less -R — Кольорове гортання без додаткових інструментів

Якщо jless не встановлено і потрібен вигляд JSON-відповіді з прокруткою та кольором, jq -C . | less -R є хорошим запасним варіантом. Прапор -C примусово вмикає ANSI-коди кольорів навіть коли stdout є пайпом (зазвичай jq їх прибирає), а -R каже less інтерпретувати коди замість виводу їх як буквальний текст. Результат — повністю кольоровий документ з прокруткою — без інтерактивної структури дерева jless. Навігація всередині less використовує клавіші зі стрілками або vim-клавіші j/k, а / запускає вбудований текстовий пошук less.

# Базовий кольоровий пейджер
jq -C . response.json | less -R

# Із curl-відповіді — -s запобігає потраплянню індикатора прогресу в JSON-потік
curl -s https://api.github.com/repos/jqlang/jq | jq -C . | less -R

# Відсортувати ключі для зручного візуального сканування, потім переглядати
jq -CS . config.json | less -R
# -C = примусовий колір, -S = сортування ключів (обидва прапори об'єднані)

# Додати псевдонім, щоб не набирати повний пайп кожного разу
alias jqv='jq -C . | less -R'
# Використання: cat response.json | jqv
#    або: curl -s https://api.example.com/status | jqv

JQ_COLORS — Налаштування колірних тем

JQ_COLORS — змінна оточення, що перевизначає стандартну ANSI-кольорову схему jq. Вона приймає рядок із семи кодів вигляду attribute;color, розділених двокрапками, по одному для кожного типу JSON у фіксованому порядку: null : false : true : числа : рядки : масиви : об'єкти. Кожен код має формат атрибут;колір, де атрибут — 0 (звичайний), 1 (жирний), 2 (тьмяний) або 4 (підкреслений), а колір — стандартний номер ANSI (30–37 = стандартні, 90–97 = яскраві).

# Довідник ANSI-кольорів для побудови JQ_COLORS:
#   Атрибути:  0=звичайний  1=жирний  2=тьмяний  4=підкреслений
#   Кольори:   30=чорний  31=червоний  32=зелений  33=жовтий
#              34=синій   35=пурпурний  36=блакитний  37=білий
#   Яскраві:   90=яскраво-чорний  91=яскраво-червоний  92=яскраво-зелений  93=яскраво-жовтий
#              94=яскраво-синій  95=яскраво-пурпурний  96=яскраво-блакитний  97=яскраво-білий
#
# Порядок: null : false : true : числа : рядки : масиви : об'єкти

# Висококонтрастна тема для темних терміналів (рекомендується)
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=темно-сірий, false=яскраво-червоний, true=яскраво-зелений,
# numbers=яскраво-жовтий, strings=зелений, arrays=жирний-блакитний, objects=жирний-блакитний

# Тема у стилі Solarized
export JQ_COLORS="2;37:0;35:0;35:0;36:0;33:1;34:1;34"
# null=тьмяно-білий, false=пурпурний, true=пурпурний,
# numbers=блакитний, strings=жовтий, arrays=жирний-синій, objects=жирний-синій

# Мінімалістична (тільки жирні ключі, все інше звичайне)
export JQ_COLORS="0;90:0;39:0;39:0;39:0;39:1;39:1;39"

# Додайте обрану тему в ~/.bashrc або ~/.zshrc для застосування до всіх викликів jq
echo 'export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"' >> ~/.bashrc
source ~/.bashrc

# Тест теми
echo '{"active":true,"errors":null,"count":42,"tags":["api","v2"],"meta":{"version":"1.0"}}' | jq .

Псевдоніми оболонки для щоденного перегляду JSON

Команди для інтерактивного перегляду JSON за замовчуванням багатослівні. Невеликий набір псевдонімів у ~/.bashrc або ~/.zshrc робить jless і кольорове гортання однослівними командами, що органічно вписуються в будь-який робочий процес. Псевдоніми нижче компонуються — jv і jvp приймають і пайпний ввід, і ім'я файлу першим аргументом.

# Додайте в ~/.bashrc або ~/.zshrc

# jv — інтерактивний переглядач (jless якщо доступний, інакше кольоровий пейджер)
jv() {
  if command -v jless &>/dev/null; then
    jless "$@"
  else
    jq -C . "$@" | less -R
  fi
}

# jvp — перегляд із ключами, відсортованими за алфавітом (зручно для порівняння відповідей)
alias jvp='jq -CS . | less -R'

# jvc — перегляд із буфера обміну (macOS)
alias jvc='pbpaste | jless'

# jvf — перегляд із фільтром: jvf '.users[0]' response.json
jvf() {
  local filter="$1"; shift
  jq -C "$filter" "$@" | less -R
}

# Перезавантаження без перезапуску терміналу
source ~/.bashrc

# Приклади використання після додавання псевдонімів

# Перегляд файлу або пайпної відповіді
jv deployment-config.json
curl -s https://api.github.com/users/torvalds | jv

# Перегляд із сортуванням (зручно сканувати за алфавітом)
cat feature-flags.json | jvp

# Детальний перегляд піддокумента
jvf '.database' infra/app-config.json
jvf '.users[] | select(.role == "admin")' users.json

bat — Перегляд JSON-файлів із підсвічуванням синтаксису

bat — заміна cat з підсвічуванням синтаксису, номерами рядків і вбудованим пейджером. Для JSON-файлів на диску він забезпечує чистий перегляд у стилі редактора без відкриття повноцінного текстового редактора. На відміну від jless, bat відображає файл як статичний текст — без згортання, без пошуку, без навігації окрім прокрутки. Його сила — візуальна чіткість для статичних файлів середнього розміру (конфіги, фікстури, тестові пейлоади), де потрібне підсвічування синтаксису та номери рядків, але не потрібна інтерактивна навігація деревом.

# macOS
brew install bat

# Debian / Ubuntu (бінарник може називатися batcat)
apt-get install -y bat
# alias bat=batcat   # додайте в ~/.bashrc якщо потрібно на Ubuntu

# Перегляд JSON-файлу з підсвічуванням синтаксису та номерами рядків
bat config/feature-flags.json

# Вимкнути пейджер — вивід прямо в термінал (корисно у скриптах)
bat --paging=never api-response.json

# Комбінувати з jq: форматувати через jq, переглядати через bat (зберігає підсвічування JSON)
jq '.' response.json | bat --language=json --paging=never

fx — Інтерактивний JSON-оглядач на Node.js

fx — інтерактивний JSON-переглядач на Node.js. Його інтерфейс схожий на jless — дерево що згортається, клавіатурна навігація, пошук — але додає дві функції, яких немає в jless: підтримка миші (клік для розгортання/згортання вузлів) і можливість ввести JavaScript-вираз у нижньому рядку для фільтрації документа в реальному часі. Для команд, що вже використовують Node.js, fx підходить органічно і не потребує окремого бінарника. Для чистих термінальних середовищ без Node jless — легший вибір.

# Глобальне встановлення через npm
npm install -g fx

# Або запуск без встановлення (npx кешує пакет)
curl -s https://api.github.com/users/torvalds | npx fx

# Базове інтерактивне використання
fx api-response.json
curl -s https://api.github.com/repos/jqlang/jq | fx

# У fx: клавіші зі стрілками для навігації, Enter для розгортання/згортання, / для пошуку
# Нижній рядок приймає JavaScript-вирази для живої фільтрації:
#   .name           → показати тільки поле "name"
#   .repos.slice(0,5) → перші 5 репозиторіїв

# fx також працює як неінтерактивний форматер (як jq . але з JS-синтаксисом)
# Передайте JavaScript-вираз як аргумент — без інтерактивного режиму
echo '{"users":[{"id":1,"name":"Sarah Chen"},{"id":2,"name":"Marcus Osei"}]}' \
  | fx '.users[0].name'
# Sarah Chen

# Ланцюжок із map для перетворення масивів
cat deployments.json | fx '.items.map(d => ({id: d.deploy_id, status: d.state}))'

Типові помилки

Чотири помилки, що трапляються знову і знову, коли розробники починають використовувати термінальні JSON-переглядачі — у кожної є чітке рішення, як тільки розумієш причину.

# 300-рядкова відповідь API — перші 280 рядків одразу прокручуються
curl -s https://api.github.com/users/torvalds | jq .
# Видно тільки кінець виводу — повернутися назад неможливо

# Повний документ доступний у jless — нічого не втрачається
curl -s https://api.github.com/users/torvalds | jless
# j/k для прокрутки, h/l для згортання/розгортання, / для пошуку

# Тільки 6 значень — jq мовчки використовує налаштування за замовчуванням, без вказівки причини
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96"
echo '{"ok":true}' | jq .  # кольори не змінилися — помилка не показана

# Рівно 7 значень — 6 двокрапок
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"

# Перевірити кількість перед додаванням до профілю оболонки
echo "$JQ_COLORS" | tr -cd ':' | wc -c   # повинно вивести 6

# Вивід jless призначений для людей — передача його виробляє сміття
jless response.json | grep "request_id"
# Вивід: ANSI escape-коди та керуючі послідовності, не чистий текст

# Використовуйте jq для програмного вилучення — чисто і компонується
jq -r '.request_id' response.json | grep "req_"

# Використовуйте jless тільки як кінцеву точку в терміналі — нічого після нього
jless response.json

# -C без -R: escape-послідовності виводяться як сирий текст
jq -C . response.json | less
# Вивід: ^[[1;34m"status"^[[0m: ^[[0;32m"ok"^[[0m ...

# -C з -R: ANSI-коди інтерпретуються як справжні кольори
jq -C . response.json | less -R
# Вивід: кольоровий JSON, чистий та читабельний

jless vs jq vs bat vs fx — Порівняння інтерактивних переглядачів

Усі чотири інструменти відображають кольоровий JSON, але їхні інтерактивні можливості суттєво відрізняються. Обирайте виходячи з того, чи потрібна навігація деревом що згортається, пошук або підтримка миші — і чи є Node.js у вашому середовищі.

У більшості випадків: встановіть jless один раз і використовуйте як інтерактивний переглядач за замовчуванням. Тримайте jq -C . | less -R як запасний варіант для середовищ, де не можна встановлювати додаткові бінарники. Додайте fx якщо ваша команда працює передусім на Node.js і цінує навігацію мишею або живу JavaScript-фільтрацію.

Часті запитання

# Відкрити файл у jless, потім натиснути / для пошуку
jless api-response.json
# У jless: введіть /  →  "request_id"  →  Enter  →  n для наступного збігу

# Альтернатива через jq: витягти і вивести всі ключі, що збігаються
jq '.. | objects | with_entries(select(.key == "request_id"))' api-response.json

# Відкрити відповідь у jless
curl -s https://api.github.com/repos/jqlang/jq | jless
# У jless:
#   H            → згорнути всі ключі верхнього рівня
#   j/k          → перейти до потрібного ключа
#   l            → розгорнути тільки цю гілку
#   gg           → повернутися до кореня
#   G            → перейти до останнього елемента

# Висококонтрастна тема для темних терміналів — додайте в ~/.bashrc або ~/.zshrc
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=сірий, false=яскраво-червоний, true=яскраво-зелений,
# numbers=яскраво-жовтий, strings=зелений, arrays/objects=яскраво-блакитний

# Тест без перезавантаження оболонки
echo '{"active":true,"errors":0,"tags":["api","v2"]}' | jq .

# Невеликі дані — jq . підходить
echo '{"status":"ok","version":"2.4.1"}' | jq .

# Велика або вкладена відповідь — краще jless
curl -s https://api.github.com/repos/jqlang/jq | jless
# → інтерактивне дерево, нічого не прокручується за екран

# Інтерактивне дослідження через jless
curl -s https://api.github.com/users/torvalds | jless

# Запасний варіант — кольоровий пейджер (без згортання, але з прокруткою і кольором)
curl -s https://api.github.com/users/torvalds | jq -C . | less -R

# tmux поруч: розділити горизонтально, потім запустити jless у кожній панелі
tmux split-window -h
# Ліва панель:  jless response-v1.json
# Права панель: jless response-v2.json

# Або використовувати diff на нормалізованому через jq виводі
diff <(jq -S . response-v1.json) <(jq -S . response-v2.json)

Пов'язані інструменти

Інструмент JSON Pretty Print дає такий самий вигляд що згортається і кольоровий, як jless — прямо в браузері, без встановлення і без терміналу.