Расширенный журнал Git

Как видите, верхний коммит активен (отмечен указателем HEAD) и находится на конце ветки main. На второй коммит указывает другая ветка, под названием feature. Наконец, четвертый коммит отмечен тегом v0.9.

Ветки, теги, указатель HEAD и история коммитов — вот почти полный перечень информации, содержащейся в репозитории Git и дающей комплексное представление о его логической структуре.

В команду git log можно добавлять всяческие параметры для просмотра различий, вносимых коммитом. Два самых распространенных варианта — это --stat и -p.

Параметр --stat позволяет просмотреть количество вставок и удалений в каждом файле, который был изменен тем или иным коммитом. (Обратите внимание, что изменение строки записывается как одна вставка и одно удаление.) Такая запись полезна, когда нужен краткий обзор изменений, внесенных каждым коммитом. Например, следующий коммит добавил в файл hello.py 67 строк и удалил из него 38 строк:

Количество знаков «+» и «-» рядом с именем файла соответствует относительному количеству изменений, внесенных коммитом в файл. Эти сведения упрощают поиск изменений, соответствующих любому из коммитов.

Для просмотра содержимого изменений, внесенных каждым коммитом, передайте команде git log параметр -p. Вывод будет содержать полный патч коммита:

Команда git shortlog — специальная разновидность git log, предназначенная для написания объявлений о релизах. С ее помощью можно сгруппировать коммиты по автору и вывести первые строки всех комментариев к ним. Так сразу становится понятно, кто над чем работал.

Например, если два разработчика сделали пять коммитов в проект, вывод git shortlog может быть следующим:

По умолчанию команда git shortlog сортирует выходные данные по имени автора, но их также можно отсортировать по количеству коммитов на автора, добавив параметр -n.

Параметр --graph используется для построения диаграммы из символов ASCII, отражающей структуру веток в истории коммитов. Обычно его используют в сочетании с командами --oneline и --decorate, чтобы обозначить связи между коммитами и ветками:

Ниже показан вывод команды для простого репозитория всего с двумя ветками:

Звездочки показывают принадлежность коммитов к той или иной ветке. Так, мы видим, что коммиты 23ad9ad и 16b36c6 находятся в тематической ветке, а остальные — в ветке main.

Этот параметр хорош для наглядного представления простых репозиториев. Для проектов со сложной структурой веток лучше использовать полноценные средства визуализации, такие как gitk или Sourcetree.

В остальных случаях для форматирования вывода git log можно использовать параметр --pretty=format:"<строка>". Он позволяет отобразить коммиты так, как вам нужно, с помощью заполнителей типа printf.

Так, например, символы %cn, %h и %cd в следующей команде будут заменяться соответственно на имя разработчика, сокращенный хеш коммита и дату разработчика.

Таким образом, каждый коммит примет следующий формат:

Весь список заполнителей можно посмотреть в разделе Pretty Formats (Форматы pretty) на странице руководства по команде git log.

С помощью параметра --pretty=format:"<строка>" удобно не только просматривать исключительно то, что вас интересует, но и передавать вывод git log другой команде.

Научиться форматировать представление коммитов с помощью git log — только полдела. Нужно еще освоить перемещение по истории коммитов. Остаток этой статьи посвящен продвинутым способам поиска конкретных коммитов в истории проекта с помощью команды git log. Каждый из них можно сочетать с любым из параметров форматирования, описанных выше.

Если вы ищете коммит, относящийся к определенному периоду, можно использовать флаги --after или --before, чтобы отфильтровать коммиты по дате. Оба флага принимают различные форматы даты в качестве параметра. Например, в вывод следующей команды попадут только коммиты, созданные после 1 июля 2014 года (включительно):

Можно также передать команде относительные ссылки, например 1 week ago‎ (1 неделю назад) или yesterday (вчера)‎:

Чтобы найти коммиты, созданные в промежутке между двумя датами, можно использовать оба флага, --before и --after, и указать соответствующие даты в качестве их значений. Так, для просмотра всех коммитов, добавленных с 1 по 4 июля 2014 года, используйте следующую команду:

Если вас интересуют только коммиты, созданные конкретным пользователем, воспользуйтесь флагом --author. Он принимает регулярные выражения и возвращает все коммиты, автор которых соответствует указанному значению. Если вы точно знаете, кого ищете, то вместо регулярного выражения можно использовать обычную строку:

Эта команда покажет все коммиты, в имени автора которых есть слово John (Джон). Точное совпадение необязательно — достаточно, чтобы имя содержало указанную фразу.

Можно также создавать сложные поисковые запросы с помощью регулярных выражений. Например, следующая команда позволит найти коммиты, автором которых является Mary (Мэри) или John (Джон).

Обратите внимание, что адрес электронной почты также относится к имени автора, поэтому этот параметр можно использовать и для поиска по адресу.

Если в вашем рабочем процессе роли авторов и разработчиков разделены, для поиска коммитов по именам разработчиков можно таким же образом использовать флаг --committer.

Для фильтрации коммитов по комментариям используется флаг --grep. Он работает точно так же, как флаг --author, описанный выше, только значения сопоставляются не с именем автора, а с комментарием к коммиту.

К примеру, если команда добавляет в комментарий к каждому коммиту соответствующие номера задач, можно использовать следующую команду для вывода всех коммитов, связанных с нужной задачей:

Можно также передать команде git log параметр -i: в этом случае различие в регистрах при сопоставлении будет игнорироваться.

Иногда нужно найти только изменения, внесенные в конкретный файл. Чтобы просмотреть историю, связанную с файлом, достаточно указать путь к нему. Так, следующая команда вернет все коммиты, посредством которых был изменен файл foo.py или bar.py:

Параметр «--» указывает команде git log на то, что последующие аргументы — это пути к файлам, а не имена веток. Если вы уверены, что перепутать путь с веткой невозможно, параметр «--» можно опустить.

Можно также искать коммиты, которые добавляют или удаляют определенную строку исходного кода. Эта операция называется pickaxe и задается выражением -S"<строка>". Например, чтобы узнать, когда строка Hello, World! (Привет, мир!) была добавлена в любой из файлов проекта, используйте команду:

Если вместо строки для поиска используется регулярное выражение, измените флаг на -G"<регулярное выражение>".

Это очень мощное средство отладки, поскольку с его помощью можно найти все коммиты, влияющие на отдельную строку кода. Можно даже узнать, когда строка была скопирована или перемещена в другой файл.

Чтобы просмотреть коммиты из определенного диапазона, укажите его в команде git log. Диапазон указывают в следующем формате, где <с> и <по> представляют собой ссылки на коммиты:

Эта команда особенно полезна, если вы используете в качестве параметров ссылки на ветки, и позволяет без труда вывести различия между двумя ветками. Рассмотрим следующую команду:

Диапазон main..feature включает все коммиты, принадлежащие к ветке feature, но не к ветке main. Иными словами, он показывает, что нового появилось в ветке feature с момента создания форка от ветки main. Наглядно это можно представить так:

Обратите внимание, что если поменять местами границы диапазона (feature..main), то будут выведены все коммиты, присутствующие в main, но отсутствующие в feature. Если команда git log возвращает коммиты для обоих рассмотренных диапазонов, значит, истории веток разошлись.

По умолчанию вывод git log включает коммиты слияния. Но если ваша команда придерживается политики «‎только слияние» (то есть объединяет восходящие изменения с тематическими ветками, вместо того чтобы перебазировать тематические ветки на вышестоящие), в истории проекта появляется много побочных коммитов слияния.

Эти коммиты слияния можно исключить из вывода git log, указав флаг --no-merges:

И наоборот, если вас интересуют только коммиты слияния, используйте флаг --merges:

Он возвращает все коммиты, у которых есть как минимум два родителя.

Надеюсь, теперь вы сможете уверенно пользоваться расширенными параметрами git log для форматирования выходных данных и фильтрации отображаемых коммитов. Это позволит извлекать из истории проекта ровно то, что вам нужно.

Новые навыки станут важным дополнением к вашему инструментарию Git, однако не забывайте, что git log часто используют вместе с другими командами. Обычно найденный коммит передают команде git checkout, git revert или другому инструменту, позволяющему воздействовать на историю коммитов. Поэтому не останавливайтесь на достигнутом и продолжайте изучать расширенные возможности Git.