Git prune

Вывод команды git log показывает два коммита и соответствующие комментарии к коммитам об изменениях, внесенных в hello.txt. На следующем шаге нужно сделать один из коммитов недоступным. Мы сделаем это с помощью команды git reset. Мы сбросим состояние репозитория до первого коммита: «added hello.txt».

Если мы теперь запустим git log для проверки состояния репозитория, то увидим, что у нас всего один коммит.

Демонстрационный репозиторий теперь находится в состоянии, содержащем открепленный коммит. Второй сделанный нами коммит с сообщением о добавленной строке («added another line to hello.txt») отображается в выводе git log и теперь откреплен. Может показаться, что мы потеряли или удалили коммит, но Git очень строго сохраняет историю. Мы можем убедиться, что он по-прежнему доступен, хоть и откреплен, переключившись на него напрямую с помощью команды git checkout:

Когда мы переключаемся на открепленный коммит, Git любезно выводит подробное сообщение, указывающее, что мы находимся в открепленном состоянии. Если сейчас изучить журнал, мы увидим, что в нем снова появился коммит «added another line to hello.txt». Теперь мы знаем, что состояние репозитория хорошо имитирует ситуацию с открепленным коммитом, и можем попрактиковаться в использовании команды git prune. Но сначала вернемся к ветке main с помощью команды git checkout.

Когда мы возвращаемся к ветке main через git checkout, Git снова любезно сообщает, что у нас остался открепленный коммит. Время его обрезать! Далее мы выполним команду git prune, но важно передать ей некоторые параметры. С флагами --dry-run и --verbose она выведет сведения об обрезаемых данных, но пока не обрежет их.

Скорее всего, вывод команды будет пустым. Это означает, что обрезка на самом деле ничего не удалит. Почему так? Скорее всего, коммит не полностью откреплен. Где-то в Git все еще существует ссылка на него. Это яркий пример того, почему git prune не стоит использовать отдельно от git gc. А еще это наглядно показывает, насколько трудно полностью потерять данные в Git.

Скорее всего, Git хранит ссылку на наш открепленный коммит в журнале ссылок. Заглянуть туда можно, выполнив команду git reflog. В ее выводе должна быть последовательность действий, которые мы предприняли, чтобы попасть в текущее состояние. Дополнительную информацию о команде git reflog можно найти на странице git reflog. Git не только сохраняет историю в журнале ссылок, но и обрезает открепленные коммиты по истечении определенных внутренних сроков. Опять же, за эти детали реализации отвечает команда git gc, поэтому git prune не стоит использовать отдельно.

Чтобы завершить демонстрацию работы git prune, очистим журнал ссылок.

Приведенная выше команда принудительно удалит все записи в журнале ссылок, созданные ранее настоящего момента. Это грубая и опасная команда, которую не стоит использовать неподготовленному пользователю Git. Мы выполняем эту команду, только чтобы продемонстрировать успешное выполнение git prune. После полного удаления журнала ссылок можно вызвать git prune.

Эта команда выведет список ссылок на объекты Git SHA вроде показанного выше.

У git prune есть небольшой список параметров, которые мы рассмотрели в обзорном разделе.

Не выполняет обрезку. Просто выводит обрезаемые объекты.

Подробно отображает все объекты и действия, выполненные при обрезке.

Выводит данные, показывающие прогресс выполнения обрезки.

Принудительно завершает действие просроченных объектов.

При указании будут сохранены все параметры ссылки на этот указатель.

Команды git remote prune и git fetch --prune делают одно и то же: удаляют ссылки, которых не существует в удаленном репозитории. Это весьма полезно при командном рабочем процессе, где ветки удаляются после слияния с main. Вторая команда, git fetch --prune, перед обрезкой подключается к удаленному репозиторию и получает его последнее состояние. По сути, это сочетание команд:

Обычная команда git prune действует совсем по-другому. Как объяснялось в обзорном разделе, git prune удаляет локально открепленные коммиты.

git fetch --prune — лучшая утилита для очистки устаревших веток. Она подключатся к удаленному репозиторию с общим доступом и получает все ссылки на удаленные ветки. Затем ссылки, которые больше не используются в удаленном репозиторию, обрезаются.

Нет, git remote prune origin обрезает ссылки только на удаленные ветки, которые больше не существуют. Git хранит как локальные, так и удаленные ссылки. В репозитории содержатся наборы ссылок local/origin и remote/origin. git remote prune origin обрезает только ссылки remote/origin. Это безопасно для локальной работы в local/origin.

Команда git prune предназначена для вызова в качестве дочерней команды при запуске git gc. Крайне маловероятно, что вам когда-нибудь понадобится использовать git prune при повседневной разработке программного обеспечения. Чтобы понять, как действует git prune, необходимы другие команды. Помимо прочего, в этой статье мы использовали git log, git reflog и git checkout.