Красивый вывод: цвета и таблицы в терминале

Терминал рисует цвет по escape-последовательностям: это обычные байты в потоке вывода, начинающиеся с escape-символа 0x1b, за которым идёт открывающая скобка и параметры. Такая конструкция называется CSI-последовательностью, а команды, меняющие цвет и стиль, — кодами SGR. Печать \x1b[32m включает зелёный цвет текста, \x1b[1m — жирный, а \x1b[0m сбрасывает всё к обычному виду. Терминал эти байты перехватывает и красит; файл, лог-сборщик или соседняя программа по пайпу — не перехватывает, для них это мусорные символы в тексте. Из этого следует главное правило цветного вывода: красить можно только когда потребитель — живой терминал, и всегда заканчивать раскрашенный фрагмент сбросом, иначе цвет «протечёт» на весь остаток экрана. Сброс забывают чаще всего: одна красная ошибка без \x1b[0m в конце — и приглашение шелла до конца сессии красное.

Библиотека github.com/fatih/color — стандарт де-факто для цветного вывода в Go CLI, ею пользуется половина известных утилит. Тип color.Color хранит набор атрибутов: color.New(color.FgGreen, color.Bold) — зелёный жирный, а методы Sprint, Sprintf и PrintFunc возвращают раскрашенную строку с уже правильным сбросом в конце. Стили объявляются один раз в пакете как переменные — okStyle, errStyle, warnStyle — и используются во всех командах, так что «готово» везде одинаково зелёное, а не пятью оттенками. Самое ценное у библиотеки внутри: глобальный флаг NoColor. При старте color сам проверяет, смотрит ли stdout в терминал, и уважает переменную NO_COLOR — если вывели в файл или пайп, Sprint вернёт текст без единого лишнего байта. То есть правило отключения цвета уже встроено, и это основная причина взять fatih/color вместо ручных \x1b[32m.

Пайп — главный потребитель вывода CLI: notes list | grep срочно, notes list > backup.txt, вызов из скрипта. Потребителю по пайпу коды цвета не нужны и вредны, поэтому вывод решает: терминал — красим, не терминал — нет. Проверку делает isatty.IsTerminal(os.Stdout.Fd()) из модуля github.com/mattn/go-isatty: он спрашивает у дескриптора stdout, тот ли это тип файла. fatih/color делает эту проверку сам при инициализации пакета, вручную она нужна, когда вы красите что-то вне color — например, склеиваете цвет с таблицей. Второй выключатель — переменная окружения NO_COLOR: соглашение с сайта no-color.org гласит, что любая непустая NO_COLOR в окружении запрещает цвет, и пользователи ставят её глобально, когда хотят цветной вывод go cli отключить раз и навсегда. fatih/color уважает NO_COLOR из коробки; в ручных проверках учитывайте её явно. Для тонкого контроля добавляют флаг --color со значениями auto, always, never: auto — по isatty, always — красить даже в пайп (для less -R), never — выключить насильно.

За таблицы в терминале у большинства утилит отвечает text/tabwriter из стандартной библиотеки. Идея простая: вы печатаете строки, разделяя колонки символом \t, а tabwriter собирает колонки в буфер, считает ширину каждой по самой длинной ячейке и дополняет остальные пробелами до ровного столбца. Конструктор NewWriter(output, minwidth, tabwidth, padding, padchar, flags) принимает пять чисел и флаг; рабочая связка для CLI — minwidth 0, padding 2, пробел как заполнитель: ячейка получит ширину максимум плюс два пробела. Важная механика: tabwriter не знает, где таблица кончилась, и пишет в output кусками — строка с меньшим числом ячеек или вызов Flush завершают блок, и тогда буфер выгружается. Отсюда привычка ставить defer w.Flush() сразу после создания: забытый Flush — классическая ошибка, при которой терминал молчит, а программа завершилась успешно. Для таблиц, где ширина важнее простоты, есть флаг AlignRight, но в CLI чаще хватает выравнивания влево по умолчанию.

Вывод — вторая половина диалога с терминалом, первую делали в уроке про вопросы и подтверждения. Дальше по курсу цвета пригодятся сразу в двух местах: в итоговом проекте таблица задач печатается именно через tabwriter с цветным заголовком и флагом --color, а разбор структуры большого проекта покажет, где живут стили цвета в реальном репозитории — в отдельном файле с остальными помощниками вывода. Обзор курса и соседние темы — на странице Cobra. Домашнее задание: добавьте таблицу с tabwriter к самой многословной команде своей утилиты, заведите стили цвета одним блоком переменных и проверьте три сценария — живой терминал, пайп в head и NO_COLOR=1. Последний проверьте дважды: с пустой NO_COLOR и с NO_COLOR=1 — по соглашению пустая переменная цвет не запрещает.