Журнал ссылок (reflog) в Git¶

Журнал ссылок (reflog) — это механизм системы контроля версий Git, который ведёт локальную историю изменений позиций веток, тегов и специальной ссылки HEAD. В отличие от коммитов, reflog фиксирует не сами изменения дерева файлов, а факты перемещения указателей (ссылок) на эти коммиты, включая операции, которые не создают новых объектов (например, переключение веток, сброс или переписывание истории). Журнал хранится в служебных файлах внутри каталога .git и не передаётся на удалённые серверы при выполнении git push или git pull.

¶Назначение и принцип работы

Reflog создан для защиты от случайной потери данных при выполнении «опасных» команд. Если пользователь выполняет git reset --hard, git rebase или git checkout на старый коммит, предыдущее состояние ветки не теряется бесследно — оно сохраняется в журнале. Это позволяет восстановить утраченные коммиты и вернуть репозиторий к прежнему состоянию в течение определённого времени.

Записи в журнале создаются автоматически при каждом изменении ссылки. Каждая запись содержит:

• старое и новое значение SHA-1 хеша (идентификаторы коммитов);
• имя ссылки (например, HEAD, refs/heads/main);
• метку времени (timestamp);
• описание операции (например, commit, checkout, reset, rebase).

¶Типы журналов

Git ведёт два основных вида журналов:

• Журнал ссылок веток (refs/heads/<имя_ветки>): хранит историю перемещений конкретной ветки. Просматривается командой git reflog <имя_ветки>.
• Журнал HEAD (HEAD): фиксирует все операции, которые влияют на текущую позицию рабочей копии, включая переключение веток и коммиты. Просматривается командой git reflog без аргументов.

Дополнительно существует журнал для тегов (refs/tags/), однако он обновляется реже, поскольку теги обычно создаются один раз и не перемещаются.

¶Основные команды

Для работы с журналом используются следующие команды:

• git reflog — отображение журнала HEAD;
• git reflog show <ссылка> — просмотр истории конкретной ветки или тега;
• git reflog --all — вывод всех журналов репозитория;
• git reflog --date=iso — отображение записей с читаемыми датами.

Восстановление состояния выполняется через git reset или git cherry-pick с указанием хеша коммита из журнала. Например, для отмены сброса ветки main к состоянию, предшествующему операции reset, используется команда git reset --hard main@{1}.

¶Срок хранения записей

Записи reflog автоматически очищаются (сборщиком мусора Git) по истечении срока давности. По умолчанию действуют два периода:

• записи, достижимые из текущего состояния веток, хранятся 90 дней (настраивается параметром gc.reflogExpire);
• записи, недоступные из текущего состояния (например, после переписывания истории), хранятся 30 дней (параметр gc.reflogExpireUnreachable).

Эти сроки можно изменить в конфигурации репозитория. Принудительная очистка выполняется командой git gc --prune=now.

¶Практическое применение

Журнал ссылок используется в следующих сценариях:

• Восстановление после ошибочного git reset: позволяет вернуть удалённые коммиты, если хеш известен из журнала.
• Отмена переписывания истории: после git rebase или git filter-branch прежние коммиты остаются в reflog и могут быть восстановлены.
• Диагностика ошибок: анализ журнала помогает понять, какие команды и в каком порядке выполнялись с репозиторием.
• Восстановление случайно удалённой ветки: если ветка была удалена, её последнее состояние сохраняется в журнале HEAD.

¶Ограничения и особенности

Reflog не является полноценным инструментом резервного копирования. Он хранит только записи о перемещении ссылок, но не сами объекты Git. Если сборщик мусора удалил недостижимые коммиты (например, после истечения срока хранения), восстановить их через reflog станет невозможно. Кроме того, журнал не передаётся на удалённые серверы, поэтому он бесполезен для восстановления данных на другом компьютере.

Для централизованного резервирования репозиториев применяются push-зеркала или серверные хуки, а reflog остаётся локальным инструментом «страховки» разработчика.

¶Источники

• Чакон С., Штрауб Б. «Pro Git» (второе издание), глава 10.
• Официальная документация Git: git-reflog(1), git-gc(1).
• Документация Git Book: «Maintaining a repository».