Коротко о главном
bat показывает содержимое файла с цветовым выделением и дополнительными ориентирами. Он полезен при чтении кода, конфигураций и журналов, а также в качестве просмотрщика для fzf и git. В статье настроим тему, стили, диапазоны строк и аккуратный вывод в конвейерах. Утилита доступна во всех основных дистрибутивах Linux.
Подсветка синтаксиса ускоряет восприятие сложных файлов. Номера строк и маркеры изменений помогают ориентироваться в больших исходниках. bat умеет работать как фильтр и не ломает конвейеры при правильных флагах. В результате меньше времени уходит на поиск нужного фрагмента.
bat редко ломается сам по себе. Чаще проблема в неверной конфигурации, устаревшей версии или команде, скопированной без понимания. Разберём типичные сбои и способы их исправления.
Почему это происходит
Ошибки почти всегда связаны с контекстом: другая версия пакета, не тот пользователь, устаревший конфиг или команда из руководства для другой системы. bat не исключение. Поэтому сначала фиксируем исходное состояние, затем меняем одну вещь за раз.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. Команда bat не найдена в Debian или Ubuntu.
Пакет установлен под именем bat, но бинарный файл называется batcat. Запустите batcat —version или создайте алиас.
2. Настройки из ~/.config/bat/config не применяются.
Проверьте путь и синтаксис файла. Переменная BAT_CONFIG_PATH может указывать на другой файл и перекрывать стандартный.
3. bat сообщает unknown theme.
Посмотрите доступные темы через bat —list-themes и укажите точное имя. Тема из конфигурации должна поддерживаться установленной версией.
4. В конвейере пропали цвета.
Добавьте —color=always. По умолчанию bat отключает оформление, когда вывод не является терминалом.
Как настроить правильно
Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install bat
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install bat
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S bat
1. Откройте файл с подсветкой
Передайте bat путь к файлу, и он определит язык по расширению. Номера строк и заголовок помогают быстрее ориентироваться. Для выхода из постраничного просмотра нажмите q.
bat --version
bat src/main.c
2. Выберите тему
Список встроенных тем выводится флагом —list-themes. Тему можно указать при запуске или закрепить в конфигурации. Проверьте контрастность на своём терминале, особенно если используется светлая схема.
bat --list-themes | head -n 20
bat --theme='Monokai Extended' src/main.c
3. Покажите только нужные строки
Флаг -r принимает диапазон в формате начало:конец. Можно открыть только начало файла или участок до конца. Это удобно для больших логов и сгенерированного кода.
bat -r 10:30 src/main.c
bat -r :20 src/main.c
bat -r 40: src/main.c
4. Используйте bat в конвейере
При перенаправлении вывода bat по умолчанию отключает оформление. Флаг —color=always сохраняет цвета, а -p убирает номера строк и заголовок. Такой режим подходит для передачи в less или fzf.
bat -p src/main.c
bat --color=always src/main.c | head -n 20
Рабочий конфиг
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
# ~/.config/bat/config
--theme="Monokai Extended"
--style="numbers,changes,header"
--italic-text=always
--paging=never
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. В Debian и Ubuntu команда называется batcat, поэтому используйте batca
В Debian и Ubuntu команда называется batcat, поэтому используйте batcat или алиас на bat.
Совет 2. Переменная BAT_THEME позволяет временно сменить тему без правки конфиг
Переменная BAT_THEME позволяет временно сменить тему без правки конфигурации.
Совет 3. Флаг -pp включает максимально простой вывод без номеров, заголовка и о
Флаг -pp включает максимально простой вывод без номеров, заголовка и оформления.
Совет 4. Для просмотра списка поддерживаемых языков выполните bat —list-langua
Для просмотра списка поддерживаемых языков выполните bat —list-languages.
Профилактика
Большинство повторяющихся сбоев с bat связано не с ошибкой в самой программе, а с окружением: обновились зависимости, изменился путь, закончилось место или другой администратор поправил конфиг. Поэтому профилактика начинается с фиксации исходного состояния.
Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.
Чек-лист
- Версия пакета и конфигурация зафиксированы и доступны для сравнения.
- Есть автоматическая проверка синтаксиса перед перезапуском службы.
- Журналы ротуются, а диск не заполняется ими за неделю.
- Изменения проходят через тестовый стенд, а не сразу на рабочий сервер.
Итог
Большинство ошибок с bat лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.