Просмотр истории коммитов Git

Просмотр истории коммитов Git помогает понять изменения в коде и ход разработки.

Git предоставляет несколько команд и параметров для просмотра истории коммитов — от простых журналов до подробных diff-ов.

Для истории коммитов Git обычно используются две распространённые команды:

  • git log— просмотр исторических записей о коммитах.
  • git blame <file>— просмотр исторических записей изменений указанного файла в виде списка.

git log

После создания нескольких коммитов в Git или после клонирования проекта, если вы хотите просмотреть историю коммитов, можно использоватьgit logдля просмотра.

git logКоманда используется для просмотра истории коммитов в репозитории Git.

git logОна отображает всю информацию о коммитах от последнего до самого раннего, включая хеш коммита, автора, дату коммита и сообщение коммита и т. д.

git logБазовый синтаксис команды:

git log [选项] [分支名/提交哈希]

Распространённые параметры включают:

  • -p: Показать патч коммита (конкретные изменения).
  • --oneline: Показать информацию о коммите в кратком однострочном формате.
  • --graph: Отображать и объединять в графическом виде.
  • --decorate: Показывать коммиты, на которые указывают ветки и теги.
  • --author=<作者>: Показывать только коммиты указанного автора.
  • --since=<时间>: Показывать только коммиты после указанного времени.
  • --until=<时间>: Показывать только коммиты до указанного времени.
  • --grep=<模式>: Показывать только сообщения коммитов, содержащие указанный шаблон.
  • --no-merges: Не показывать коммиты слияния.
  • --stat: Отображать краткую статистику, включая изменённые файлы и количество строк.
  • --abbrev-commit: Использовать короткие хеши коммитов.
  • --pretty=<格式>: Использовать пользовательский формат для отображения коммита.

Для операций из нашей предыдущей главы используйте командуgit log, чтобы вывести историю коммитов следующим образом:

$ git log
commit d5e9fc2c811e0ca2b2d28506ef7dc14171a207d9 (HEAD -> master)
Merge: c68142b 7774248
Author: example <test@example.com>
Date:   Fri May 3 15:55:58 2019 +0800

    Merge branch 'change_site'

commit c68142b562c260c3071754623b08e2657b4c6d5b
Author: example <test@example.com>
Date:   Fri May 3 15:52:12 2019 +0800

    修改代码

commit 777424832e714cf65d3be79b50a4717aea51ab69 (change_site)
Author: example <test@example.com>
Date:   Fri May 3 15:49:26 2019 +0800

    changed the example.php

commit c1501a244676ff55e7cccac1ecac0e18cbf6cb00
Author: example <test@example.com>
Date:   Fri May 3 15:35:32 2019 +0800

Мы можем использовать опцию --oneline, чтобы вывести краткую версию истории.

$ git log --oneline
$ git log --oneline
d5e9fc2 (HEAD -> master) Merge branch 'change_site'
c68142b 修改代码
7774248 (change_site) changed the example.php
c1501a2 removed test.txt、add example.php
3e92c19 add test.txt
3b58100 第一次版本提交

Это показывает нам историю разработки этого проекта.

Мы также можем использовать опцию --graph, чтобы увидеть, когда в истории появлялись ветки и слияния. Ниже приведена та же команда с включённой опцией графа топологии:

*   d5e9fc2 (HEAD -> master) Merge branch 'change_site'
|\  
| * 7774248 (change_site) changed the example.php
* | c68142b 修改代码
|/  
* c1501a2 removed test.txt、add example.php
* 3e92c19 add test.txt
* 3b58100 第一次版本提交

Теперь мы можем яснее увидеть, когда работа расходилась и когда она снова сливалась.

Вы также можете использовать параметр--reverse, чтобы отобразить все логи в обратном порядке.

$ git log --reverse --oneline
3b58100 第一次版本提交
3e92c19 add test.txt
c1501a2 removed test.txt、add example.php
7774248 (change_site) changed the example.php
c68142b 修改代码
d5e9fc2 (HEAD -> master) Merge branch 'change_site'

Если вы хотите найти журнал коммитов только конкретного пользователя, можно использовать команду: git log --author. Например, предположим, мы хотим найти часть, закоммиченную Линусом в исходном коде Git:

$ git log --author=Linus --oneline -5
81b50f3 Move 'builtin-*' into a 'builtin/' subdirectory
3bb7256 make "index-pack" a built-in
377d027 make "git pack-redundant" a built-in
b532581 make "git unpack-file" a built-in
112dd51 make "mktag" a built-in

Если вам нужно указать дату, можно использовать несколько опций: --since и --before, но также можно использовать --until и --after.

Например, если я хочу увидеть все коммиты в проекте Git за последние три недели и после 18 апреля, я могу выполнить это (я также использовал опцию --no-merges, чтобы скрыть коммиты слияния):

$ git log --oneline --before={3.weeks.ago} --after={2010-04-18} --no-merges
5469e2d Git 1.7.1-rc2
d43427d Documentation/remote-helpers: Fix typos and improve language
272a36b Fixup: Second argument may be any arbitrary string
b6c8d2d Documentation/remote-helpers: Add invocation section
5ce4f4e Documentation/urls: Rewrite to accomodate transport::address
00b84e9 Documentation/remote-helpers: Rewrite description
03aa87e Documentation: Describe other situations where -z affects git diff
77bc694 rebase-interactive: silence warning when no commits rewritten
636db2c t3301: add tests to use --format="%N"

Общие параметры

Ограничение количества отображаемых коммитов:

git log -n <number>

Например, показать последние 5 коммитов:

git log -n 5

Показать коммиты после указанной даты:

git log --since="2024-01-01"

Показать коммиты до указанной даты:

git log --until="2024-07-01"

Показывать только коммиты конкретного автора:

git log --author="Author Name"

Подробнееgit logКоманда позволяет просмотретьhttp://git-scm.com/docs/git-logИли используйтеgit log --helpКоманда для просмотра справочной информации.


git blame

git blameКоманда используется для построчного отображения того, кто и когда внёс или изменил каждую строку кода в указанном файле.

git blameОна позволяет отслеживать историю изменений каждой строки в файле, включая такие сведения, как автор, хеш коммита, дата коммита и сообщение коммита.

Если вы хотите просмотреть историю изменений указанного файла, можно использовать команду git blame в следующем формате:

git blame [选项] <文件路径>

Распространённые параметры включают:

  • -L <起始行号>,<结束行号>: Показывать только аннотации кода в указанном диапазоне строк.
  • -C: Для переименованных или скопированных строк кода также отслеживать происхождение строки кода.
  • -M: Для перемещённых строк кода также отслеживать происхождение строки кода.
  • -C -Cили-M -M: Для строк кода со значительными изменениями выполнять дополнительное отслеживание.
  • --show-stats: Отображать статистику количества строк для каждого автора.

: Показывать аннотации кода и связанную информацию для каждой строки файла:

git blame <文件路径>

Показывать только аннотации кода в указанном диапазоне строк:

git blame -L <起始行号>,<结束行号> <文件路径>

Отслеживать происхождение переименованных или скопированных строк кода:

git blame -C <文件路径>

: Отслеживать происхождение перемещённых строк кода:

git blame -M <文件路径>

: Показывать статистику по количеству строк:

git blame --show-stats <文件路径>

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

$ git blame README 
^d2097aa (tianqixin 2020-08-25 14:59:25 +0800 1) # Example Git 测试
db9315b0 (example    2020-08-25 16:00:23 +0800 2) # Example 

Для получения дополнительной информации можно использоватьgit blame --helpПросмотрите полную справку, чтобы узнать больше о параметрах и использовании.


Восстановление и откат

Git предоставляет несколько способов восстановления и отката к предыдущим версиям; разные команды подходят для разных сценариев и потребностей.

Вот несколько распространённых методов:

  • git checkout: Переключение веток или восстановление файлов до указанного коммита.
  • git reset: Сброс текущей ветки до указанного коммита (мягкий сброс, смешанный сброс, жёсткий сброс).
  • git revert: Создание нового коммита для отмены указанного коммита без изменения истории коммитов.
  • git reflog: Просмотр истории операций и восстановление потерянных коммитов.

1. git checkout: Извлечение конкретной версии файла

Команда git checkout используется для переключения веток или восстановления файлов в рабочем каталоге до указанного коммита.

Восстановить файлы в рабочем каталоге до конкретного коммита:

git checkout <commit> -- <filename>

Например, восстановить file.txt до версии в коммите abc123:

git checkout abc123 -- file.txt

Переключиться на конкретный коммит:

git checkout <commit>

Например:

git checkout abc123

При таком переключении на конкретный коммит вы находитесь в состоянии detached HEAD.

2. git reset: Сброс текущей ветки к конкретному коммиту

Команда git reset может изменять историю коммитов текущей ветки. Она имеет три основных режима: --soft, --mixed и --hard.

--soft: Сбрасывает только HEAD к указанному коммиту, оставляя область подготовки и рабочий каталог без изменений.

git reset --soft <commit>

--mixed (по умолчанию): Сбрасывает HEAD к указанному коммиту, сбрасывает область подготовки, но оставляет рабочий каталог без изменений.

git reset --mixed <commit>

--hard: Сбрасывает HEAD к указанному коммиту, сбрасывая и область подготовки, и рабочий каталог.

git reset --hard <commit>

Например, сбросить текущую ветку к коммиту abc123:

git reset --hard abc123

3. git revert: отмена коммита

Команда git revert создаёт новый коммит для отмены указанного коммита. Она не изменяет историю коммитов и подходит для коммитов, которые уже были отправлены в удалённый репозиторий.

git revert <commit>

Например, отменить коммит abc123:

git revert abc123

4. git reflog: просмотр истории операций

Команда git reflog записывает все перемещения HEAD. Даже если коммиты удалены или сброшены, их можно восстановить через reflog.

git reflog

С помощью reflog можно найти хеш предыдущего коммита и восстановиться до определённого состояния. Например:

git reset --hard HEAD@{3}

Пример

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

Просмотр истории коммитов:

git log --oneline

Предположим, вывод выглядит следующим образом:

abc1234 Commit 1
def5678 Commit 2
ghi9012 Commit 3

Переключиться на Commit 2 (в состоянии detached HEAD):

git checkout def5678

Сбросить до Commit 2, сохранив изменения в области подготовки:

git reset --soft def5678

Сбросить до Commit 2, убрав изменения из области подготовки:

git reset --mixed def5678

Сбросить до Commit 2, отбросив все изменения:

git reset --hard def5678

Отменить Commit 2:

git revert def5678

Просмотреть reflog для восстановления потерянных коммитов:

git reflog

Найти хеш предыдущего коммита и восстановить:

git reset --hard HEAD@{3}
Другие расширения